GridView.Columns Eigenschaft

Definition

Ruft eine Auflistung der DataControlField-Objekte ab, die die Spaltenfelder in einem GridView-Steuerelement darstellen.Gets a collection of DataControlField objects that represent the column fields in a GridView control.

public:
 virtual property System::Web::UI::WebControls::DataControlFieldCollection ^ Columns { System::Web::UI::WebControls::DataControlFieldCollection ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public virtual System.Web.UI.WebControls.DataControlFieldCollection Columns { get; }
member this.Columns : System.Web.UI.WebControls.DataControlFieldCollection
Public Overridable ReadOnly Property Columns As DataControlFieldCollection

Eigenschaftswert

Eine DataControlFieldCollection, die alle Spaltenfelder im GridView-Steuerelement enthält.A DataControlFieldCollection that contains all the column fields in the GridView control.

Attribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die Columns Auflistung deklarativ aufgefüllt wird.The following example demonstrates how to populate the Columns collection declaratively.


<%@ Page language="C#" %>

<!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" >
  <head runat="server">
    <title>GridView Columns Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Columns Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        runat="server">
        
        <columns>
          <asp:boundfield datafield="CustomerID" headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName" headertext="Company Name"/>
          <asp:boundfield datafield="Address" headertext="Address"/>
          <asp:boundfield datafield="City" headertext="City"/>
          <asp:boundfield datafield="PostalCode" headertext="Postal Code"/>
          <asp:boundfield datafield="Country" headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>


<%@ Page language="VB" %>

<!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" >
  <head runat="server">
    <title>GridView Columns Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView Columns Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        runat="server">
        
        <columns>
          <asp:boundfield datafield="CustomerID" headertext="Customer ID"/>
          <asp:boundfield datafield="CompanyName" headertext="Company Name"/>
          <asp:boundfield datafield="Address" headertext="Address"/>
          <asp:boundfield datafield="City" headertext="City"/>
          <asp:boundfield datafield="PostalCode" headertext="Postal Code"/>
          <asp:boundfield datafield="Country" headertext="Country"/>
        </columns>
                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
        
    </form>
  </body>
</html>

Hinweise

Ein Spalten Feld stellt eine Spalte in einem GridView -Steuerelement dar.A column field represents a column in a GridView control. Die Columns -Eigenschaft (-Auflistung) wird zum Speichern aller explizit deklarierten Spalten Felder verwendet, die GridView im-Steuerelement gerendert werden.The Columns property (collection) is used to store all the explicitly declared column fields that get rendered in the GridView control. Sie können die Columns Auflistung auch verwenden, um die Auflistung von Spalten Feldern Programm gesteuert zu verwalten.You can also use the Columns collection to programmatically manage the collection of column fields.

Hinweis

Explizit deklarierte Spalten Felder können in Kombination mit automatisch generierten Spalten Feldern verwendet werden.Explicitly declared column fields can be used in combination with automatically generated column fields. Wenn beide verwendet werden, werden explizit deklarierte Spalten Felder zuerst gerendert, gefolgt von den automatisch generierten Spalten Feldern.When both are used, explicitly declared column fields are rendered first, followed by the automatically generated column fields. Automatisch generierte Spalten Felder werden der Columns Auflistung nicht hinzugefügt.Automatically generated column fields are not added to the Columns collection.

Die Spalten Felder werden im GridView -Steuerelement in der Reihenfolge angezeigt, in der die Spalten Felder in der Columns Auflistung angezeigt werden.The column fields are displayed in the GridView control in the order that the column fields appear in the Columns collection. In der folgenden Tabelle werden die verschiedenen Spalten Feld Klassen angezeigt, die DataControlField von der-Klasse abgeleitet sind und Columns in der-Auflistung verwendet werden können.The following table shows the different column field classes that derive from the DataControlField class and can be used in the Columns collection.

Spalten FeldtypColumn field type BeschreibungDescription
BoundField Zeigt den Wert eines Felds in einer Datenquelle an.Displays the value of a field in a data source. Dies ist der Standard Spaltentyp des GridView Steuer Elements.This is the default column type of the GridView control.
ButtonField Zeigt eine Befehls Schaltfläche für jedes Element GridView im-Steuerelement an.Displays a command button for each item in the GridView control. Auf diese Weise können Sie eine Spalte mit benutzerdefinierten Schaltflächen-Steuerelementen erstellen, z. b. die Schaltfläche Hinzufügen oder entfernen.This enables you to create a column of custom button controls, such as the Add or the Remove button.
CheckBoxField Zeigt ein Kontrollkästchen für jedes Element im- GridView Steuerelement an.Displays a check box for each item in the GridView control. Dieser Spalten Feldtyp wird häufig verwendet, um Felder mit einem booleschen Wert anzuzeigen.This column field type is commonly used to display fields with a Boolean value.
CommandField Zeigt vordefinierte Befehls Schaltflächen zum Ausführen von Auswahl-, Bearbeitungs-oder Lösch Vorgängen anDisplays predefined command buttons to perform select, edit, or delete operations.
HyperLinkField Zeigt den Wert eines Felds in einer Datenquelle als Hyperlink an.Displays the value of a field in a data source as a hyperlink. Dieser Spalten Feldtyp ermöglicht es Ihnen, ein zweites Feld an die URL des Links zu binden.This column field type enables you to bind a second field to the hyperlink's URL.
ImageField Zeigt ein Bild für jedes Element im GridView -Steuerelement an.Displays an image for each item in the GridView control.
TemplateField Zeigt den GridView benutzerdefinierten Inhalt für jedes Element im Steuerelement entsprechend einer angegebenen Vorlage an.Displays user-defined content for each item in the GridView control, according to a specified template. Dieser Spalten Feldtyp ermöglicht das Erstellen eines benutzerdefinierten Spalten Felds.This column field type enables you to create a custom column field.

Obwohl Sie der Columns Auflistung Programm gesteuert Spalten Felder hinzufügen können, ist es einfacher, die Spalten Felder deklarativ GridView im-Steuerelement aufzulisten und dann die Visible -Eigenschaft der einzelnen Spalten Felder zu verwenden, um die einzelnen Spalten Felder anzuzeigen oder auszublenden.Although you can programmatically add column fields to the Columns collection, it is easier to list the column fields declaratively in the GridView control and then use the Visible property of each column field to show or hide each column field.

Wenn die Visible -Eigenschaft eines Spalten Felds auf falsefestgelegt ist, GridView wird die Spalte nicht im-Steuerelement angezeigt, und die Daten für die Spalte machen keinen Roundtrip an den Client.If the Visible property of a column field is set to false, the column is not displayed in the GridView control and the data for the column does not make a round trip to the client. Wenn Sie möchten, dass die Daten für eine Spalte, die für einen Roundtrip nicht sichtbar ist, den Feldnamen zur DataKeyNames -Eigenschaft hinzufügen.If you want the data for a column that is not visible to make a round trip, add the field name to the DataKeyNames property.

Gilt für:

Siehe auch