GridView.Columns Eigenschaft
Definition
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
Eine DataControlFieldCollection, die alle Spaltenfelder im GridView-Steuerelement enthält.
- Attribute
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 false
festgelegt 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.