BoundColumn Klasse

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ein Spaltentyp für das DataGrid Steuerelement, das an ein Feld in einer Datenquelle gebunden ist.

public ref class BoundColumn : System::Web::UI::WebControls::DataGridColumn

public class BoundColumn : System.Web.UI.WebControls.DataGridColumn

type BoundColumn = class
    inherit DataGridColumn

Public Class BoundColumn
Inherits DataGridColumn

Vererbung: Object

DataGridColumn
BoundColumn

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie einen BoundColumn Spaltentyp im DataGrid Steuerelement verwenden, um die Felder in einer Datenquelle anzuzeigen.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script language="C#" runat="server">
 
      ICollection CreateDataSource() 
      {
         DataTable dt = new DataTable();
         DataRow dr;
 
         dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
         dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
         dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
         for (int i = 0; i < 9; i++) 
         {
            dr = dt.NewRow();
 
            dr[0] = i;
            dr[1] = "Item " + i.ToString();
            dr[2] = 1.23 * (i + 1);
 
            dt.Rows.Add(dr);
         }
 
         DataView dv = new DataView(dt);
         return dv;
      }
 
      void Page_Load(Object sender, EventArgs e) 
      {
 
         if (!IsPostBack) 
         {
            // Load this data only once.
            ItemsGrid.DataSource= CreateDataSource();
            ItemsGrid.DataBind();
         }
      }
 
   </script>
 
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script language="VB" runat="server">
    Function CreateDataSource() As ICollection
        Dim dt As New DataTable()
        Dim dr As DataRow
        
        dt.Columns.Add(New DataColumn("IntegerValue", GetType(Int32)))
        dt.Columns.Add(New DataColumn("StringValue", GetType(String)))
        dt.Columns.Add(New DataColumn("CurrencyValue", GetType(Double)))
        
        Dim i As Integer
        For i = 0 To 8
            dr = dt.NewRow()
            
            dr(0) = i
            dr(1) = "Item " + i.ToString()
            dr(2) = 1.23 *(i + 1)
            
            dt.Rows.Add(dr)
        Next i
        
        Dim dv As New DataView(dt)
        Return dv
    End Function 'CreateDataSource


    Sub Page_Load(sender As Object, e As EventArgs)
        
        If Not IsPostBack Then
            ' Load this data only once.
            ItemsGrid.DataSource = CreateDataSource()
            ItemsGrid.DataBind()
        End If
    End Sub 'Page_Load
   </script>
<head runat="server">
    <title>BoundColumn Example</title>
</head>
<body>
 
   <form id="form1" runat="server">
 
      <h3>BoundColumn Example</h3>
 
      <b>Product List</b>
 
      <asp:DataGrid id="ItemsGrid"
           BorderColor="black"
           BorderWidth="1"
           CellPadding="3"
           AutoGenerateColumns="false"
           runat="server">

         <HeaderStyle BackColor="#00aaaa">
         </HeaderStyle>

         <Columns>

            <asp:BoundColumn
                 HeaderText="Number" 
                 DataField="IntegerValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Description" 
                 DataField="StringValue">
            </asp:BoundColumn>

            <asp:BoundColumn
                 HeaderText="Price" 
                 DataField="CurrencyValue" 
                 DataFormatString="{0:c}">
            </asp:BoundColumn>

         </Columns>
 
      </asp:DataGrid>
 
   </form>
 
</body>
</html>

Hinweise

Verwenden Sie den BoundColumn Spaltentyp in einem DataGrid Steuerelement, um den Inhalt eines Felds in der Datenquelle anzuzeigen. Die Werte werden in einer einzelnen Spalte aufgelistet. Das Feld ist mit dem BoundColumnVerknüpft, sodass alle Aktualisierungen in der Datenquelle in den entsprechenden Zellen des DataGrid Steuerelements angezeigt werden.

Note

Dieser Spaltentyp ist die Standardeinstellung für das DataGrid Steuerelement.

Verwenden Sie zum Steuern der Darstellung dieser Spalte die Formatvorlageneigenschaften des DataGrid Steuerelements.

Vorsicht

Text ist nicht HTML-codiert, bevor er in der BoundColumnDatei angezeigt wird. Dadurch können Skripts in HTML-Tags in den Text eingebettet werden. Wenn die Werte für diese Spalte von der Benutzereingabe stammen, überprüfen Sie unbedingt die Werte, um Sicherheitsrisiken zu verringern.

Konstruktoren

Name	Beschreibung
BoundColumn()	Initialisiert eine neue Instanz der BoundColumn-Klasse.

Felder

Name	Beschreibung
thisExpr	Stellt die Zeichenfolge "!" dar. Dieses Feld ist schreibgeschützt.

Eigenschaften

Name	Beschreibung
DataField	Ruft den Feldnamen aus der Datenquelle ab, oder legt diesen fest, der an die BoundColumnDatenquelle gebunden werden soll.
DataFormatString	Dient zum Abrufen oder Festlegen der Zeichenfolge, die das Anzeigeformat für Elemente in der Spalte angibt.
DesignMode	Ruft einen Wert ab, der angibt, ob sich die Spalte im Entwurfsmodus befindet. (Geerbt von DataGridColumn)
FooterStyle	Ruft die Formatvorlageneigenschaften für den Fußzeilenabschnitt der Spalte ab. (Geerbt von DataGridColumn)
FooterText	Dient zum Abrufen oder Festlegen des Texts, der im Fußzeilenabschnitt der Spalte angezeigt wird. (Geerbt von DataGridColumn)
HeaderImageUrl	Dient zum Abrufen oder Festlegen der Position eines Bilds, das im Kopfzeilenabschnitt der Spalte angezeigt werden soll. (Geerbt von DataGridColumn)
HeaderStyle	Ruft die Formatvorlageneigenschaften für den Kopfzeilenabschnitt der Spalte ab. (Geerbt von DataGridColumn)
HeaderText	Dient zum Abrufen oder Festlegen des Texts, der im Kopfzeilenabschnitt der Spalte angezeigt wird. (Geerbt von DataGridColumn)
IsTrackingViewState	Ruft einen Wert ab, der bestimmt, ob das DataGridColumn Objekt zum Speichern des Zustands markiert ist. (Geerbt von DataGridColumn)
ItemStyle	Ruft die Formatvorlageneigenschaften für die Elementzellen der Spalte ab. (Geerbt von DataGridColumn)
Owner	Ruft das DataGrid Steuerelement ab, bei dem es sich bei der Spalte um ein Element handelt. (Geerbt von DataGridColumn)
ReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Elemente in der BoundColumn Bearbeitung bearbeitet werden können.
SortExpression	Dient zum Abrufen oder Festlegen des Namens des Felds oder Ausdrucks, das an die Methode übergeben werden soll, wenn eine Spalte für die OnSortCommand(DataGridSortCommandEventArgs) Sortierung ausgewählt ist. (Geerbt von DataGridColumn)
ViewState	Ruft das StateBag Objekt ab, das eine von der DataGridColumn Klasse abgeleitete Spalte zum Speichern seiner Eigenschaften zulässt. (Geerbt von DataGridColumn)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Spalte im DataGrid Steuerelement sichtbar ist. (Geerbt von DataGridColumn)

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
FormatDataValue(Object)	Konvertiert den angegebenen Wert in das von der DataFormatString Eigenschaft angegebene Format.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
Initialize()	Setzt den BoundColumn Anfangszustand zurück.
InitializeCell(TableCell, Int32, ListItemType)	Setzt die angegebene Zelle im BoundColumn Anfangszustand zurück.
LoadViewState(Object)	Lädt den Zustand des DataGridColumn Objekts. (Geerbt von DataGridColumn)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnColumnChanged()	Die OnColumnsChanged()-Methode wird aufgerufen. (Geerbt von DataGridColumn)
SaveViewState()	Speichert den aktuellen Zustand des DataGridColumn Objekts. (Geerbt von DataGridColumn)
ToString()	Gibt die Zeichenfolgendarstellung der Spalte zurück. (Geerbt von DataGridColumn)
TrackViewState()	Bewirkt die Nachverfolgung von Ansichtszustandsänderungen am Serversteuerelement, sodass sie im Objekt des Serversteuerelements StateBag gespeichert werden können. (Geerbt von DataGridColumn)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob die Spalte Ansichtszustandsänderungen nachverfolgt. (Geerbt von DataGridColumn)
IStateManager.LoadViewState(Object)	Lädt den zuvor gespeicherten Zustand. (Geerbt von DataGridColumn)
IStateManager.SaveViewState()	Gibt ein Objekt zurück, das Zustandsänderungen enthält. (Geerbt von DataGridColumn)
IStateManager.TrackViewState()	Beginnt mit der Nachverfolgung von Zustandsänderungen. (Geerbt von DataGridColumn)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?