BoundColumn Klasse

Referenz

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 aufgeführt. Das Feld ist mit verknüpft BoundColumn, sodass alle Aktualisierungen in der Datenquelle in den entsprechenden Zellen des DataGrid Steuerelements reflektiert werden.

Hinweis

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

Um die Darstellung dieser Spalte zu steuern, verwenden Sie die Formateigenschaften des Steuerelements DataGrid .

Achtung

Text ist nicht HTML-codiert, bevor er in BoundColumnangezeigt wird. Dadurch ist es möglich, Skripts in HTML-Tags im Text einzubetten. Wenn die Werte für diese Spalte aus der Benutzereingabe stammen, müssen Sie die Werte überprüfen, um Sicherheitsrisiken zu verringern.

Konstruktoren

BoundColumn()

Initialisiert eine neue Instanz der BoundColumn-Klasse.

Felder

thisExpr

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

Eigenschaften

DataField	Ruft den Namen des Felds aus der Datenquelle ab, das an diese BoundColumn gebunden werden soll, oder legt diesen fest.
DataFormatString	Ruft die Zeichenfolge ab, die das Anzeigeformat von Spaltenelementen angibt, oder legt diese fest.
DesignMode	Ruft einen Wert ab, der angibt, ob sich die Spalte im Entwurfsmodus befindet. (Geerbt von DataGridColumn)
FooterStyle	Ruft die Formatierungseigenschaften für den Fußzeilenbereich der Spalte ab. (Geerbt von DataGridColumn)
FooterText	Ruft den im Fußzeilenbereich der Spalte angezeigten Text ab oder legt diesen fest. (Geerbt von DataGridColumn)
HeaderImageUrl	Ruft den Speicherort eines Bilds ab, das im Headerbereich der Spalte angezeigt werden soll, oder legt diesen fest. (Geerbt von DataGridColumn)
HeaderStyle	Ruft die Formatierungseigenschaften für den Headerbereich der Spalte ab. (Geerbt von DataGridColumn)
HeaderText	Ruft den im Headerbereich der Spalte angezeigten Text ab oder legt diesen fest. (Geerbt von DataGridColumn)
IsTrackingViewState	Ruft einen Wert ab, der bestimmt, ob das DataGridColumn-Objekt markiert wird, um seinen Zustand zu speichern. (Geerbt von DataGridColumn)
ItemStyle	Ruft die Formatierungseigenschaften für die einzelnen Zellen der Spalte ab. (Geerbt von DataGridColumn)
Owner	Ruft das DataGrid-Steuerelement ab, zu dessen Membern die Spalte gehört. (Geerbt von DataGridColumn)
ReadOnly	Ruft einen Wert ab, der angibt, ob die Elemente in BoundColumn bearbeitet werden können, oder legt diesen fest.
SortExpression	Ruft den Namen des Felds oder Ausdrucks ab, der an die OnSortCommand(DataGridSortCommandEventArgs)-Methode übergeben wird, wenn eine Spalte für die Sortierung ausgewählt wurde, oder legt diesen fest. (Geerbt von DataGridColumn)
ViewState	Ruft das StateBag-Objekt ab, wodurch einer von der DataGridColumn-Klasse abgeleiteten Spalte ermöglicht wird, ihre Eigenschaften zu speichern. (Geerbt von DataGridColumn)
Visible	Ruft einen Wert ab, der angibt, ob die Spalte im DataGrid-Steuerelement sichtbar ist, oder legt diesen fest. (Geerbt von DataGridColumn)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FormatDataValue(Object)	Konvertiert den angegebenen Wert in das von der DataFormatString-Eigenschaft angegebene Format.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Initialize()	Setzt BoundColumn auf den Ausgangszustand zurück.
InitializeCell(TableCell, Int32, ListItemType)	Setzt die angegebene Zelle in BoundColumn auf den Ausgangszustand zurück.
LoadViewState(Object)	Lädt den Zustand des DataGridColumn-Objekts. (Geerbt von DataGridColumn)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnColumnChanged()	Aufruf der OnColumnsChanged()-Methode. (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()	Veranlasst die Überwachung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können. (Geerbt von DataGridColumn)

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob die Spalte Änderungen des Ansichtszustands nachverfolgt. (Geerbt von DataGridColumn)
IStateManager.LoadViewState(Object)	Lädt den früher gespeicherten Zustand. (Geerbt von DataGridColumn)
IStateManager.SaveViewState()	Gibt ein Objekt zurück, das Zustandsänderungen enthält. (Geerbt von DataGridColumn)
IStateManager.TrackViewState()	Startet das Verfolgen von Zustandsänderungen. (Geerbt von DataGridColumn)

Gilt für:

Teilen über