GridView.Columns Eigenschaft

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.

Ruft eine Auflistung der DataControlField-Objekte ab, die die Spaltenfelder in einem GridView-Steuerelement darstellen.

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; }

[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.Columns : System.Web.UI.WebControls.DataControlFieldCollection

Public Overridable ReadOnly Property Columns As DataControlFieldCollection

Eigenschaftswert

DataControlFieldCollection

Eine DataControlFieldCollection, die alle Spaltenfelder im GridView-Steuerelement enthält.

Attribute: PersistenceModeAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie die Columns Auflistung deklarativ auffüllen.


<%@ 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 Spaltenfeld stellt eine Spalte in einem GridView Steuerelement dar. Die Columns Eigenschaft (Auflistung) wird verwendet, um alle explizit deklarierten Spaltenfelder zu speichern, die im GridView Steuerelement gerendert werden. Sie können auch die Auflistung verwenden, um die Columns Auflistung von Spaltenfeldern programmgesteuert zu verwalten.

Hinweis

Explizit deklarierte Spaltenfelder können in Kombination mit automatisch generierten Spaltenfeldern verwendet werden. Wenn beide verwendet werden, werden explizit deklarierte Spaltenfelder zuerst gerendert, gefolgt von den automatisch generierten Spaltenfeldern. Automatisch generierte Spaltenfelder werden der Columns Auflistung nicht hinzugefügt.

Die Spaltenfelder werden im Steuerelement in der GridView Reihenfolge angezeigt, in der die Spaltenfelder in der Columns Auflistung angezeigt werden. Die folgende Tabelle zeigt die verschiedenen Spaltenfeldklassen, die von der Klasse abgeleitet werden und in der DataControlField Columns Auflistung verwendet werden können.

Spaltenfeldtyp	BESCHREIBUNG
BoundField	Zeigt den Wert eines Felds in einer Datenquelle an. Dies ist der Standardspaltentyp des GridView Steuerelements.
ButtonField	Zeigt eine Befehlsschaltfläche für jedes Element im GridView Steuerelement an. Dadurch können Sie eine Spalte benutzerdefinierter Schaltflächensteuerelemente erstellen, z. B. die Schaltfläche "Hinzufügen" oder "Entfernen".
CheckBoxField	Zeigt ein Kontrollkästchen für jedes Element im GridView Steuerelement an. Dieser Spaltenfeldtyp wird häufig verwendet, um Felder mit einem Booleschen Wert anzuzeigen.
CommandField	Zeigt vordefinierte Befehlsschaltflächen an, um Ausgewählte, Bearbeitungs- oder Löschvorgänge auszuführen.
HyperLinkField	Zeigt den Wert eines Felds in einer Datenquelle als Hyperlink an. Mit diesem Spaltenfeldtyp können Sie ein zweites Feld an die URL des Links binden.
ImageField	Zeigt ein Bild für jedes Element im GridView Steuerelement an.
TemplateField	Zeigt benutzerdefinierte Inhalte für jedes Element im GridView Steuerelement gemäß einer angegebenen Vorlage an. Mit diesem Spaltenfeldtyp können Sie ein benutzerdefiniertes Spaltenfeld erstellen.

Obwohl Sie spaltenfelder programmgesteuert zur Columns Auflistung hinzufügen können, ist es einfacher, die Spaltenfelder deklarativ im GridView Steuerelement auflisten und dann die Visible Eigenschaft jedes Spaltenfelds zu verwenden, um jedes Spaltenfeld anzuzeigen oder auszublenden.

Wenn die Visible Eigenschaft eines Spaltenfelds auf falsefestgelegt ist, wird die Spalte nicht im GridView Steuerelement angezeigt, und die Daten für die Spalte machen keine Rundreise zum Client. Wenn Die Daten für eine Spalte, die nicht sichtbar ist, um einen Rundtrip vorzunehmen, fügen Sie den Feldnamen zur DataKeyNames Eigenschaft hinzu.

Gilt für