GridView.AutoGenerateSelectButton 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 einen Wert ab, der angibt, ob für jede Datenzeile automatisch eine CommandField-Feldspalte mit einer Schaltfläche Auswählen zu einem GridView-Steuerelement hinzugefügt wird, oder legt diesen Wert fest.
public:
virtual property bool AutoGenerateSelectButton { bool get(); void set(bool value); };public virtual bool AutoGenerateSelectButton { get; set; }member this.AutoGenerateSelectButton : bool with get, setPublic Overridable Property AutoGenerateSelectButton As BooleanEigenschaftswert
true, wenn automatisch eine CommandField-Feldspalte mit einer Schaltfläche Auswählen für jede Datenzeile hinzugefügt werden soll, andernfalls false. Der Standardwert ist false.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie die AutoGenerateSelectButton Eigenschaft verwenden, um das Feature für die automatische Auswahl des GridView Steuerelements zu aktivieren.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void CustomersGridView_SelectedIndexChanged(Object sender, EventArgs e)
{
// Get the currently selected row using the SelectedRow property.
GridViewRow row = CustomersGridView.SelectedRow;
// Display the first name from the selected row.
// In this example, the third column (index 2) contains
// the first name.
MessageLabel.Text = "You selected " + row.Cells[2].Text + ".";
}
void CustomersGridView_SelectedIndexChanging(Object sender, GridViewSelectEventArgs e)
{
// Get the currently selected row. Because the SelectedIndexChanging event
// occurs before the select operation in the GridView control, the
// SelectedRow property cannot be used. Instead, use the Rows collection
// and the NewSelectedIndex property of the e argument passed to this
// event handler.
GridViewRow row = CustomersGridView.Rows[e.NewSelectedIndex];
// You can cancel the select operation by using the Cancel
// property. For this example, if the user selects a customer with
// the ID "ANATR", the select operation is canceled and an error message
// is displayed.
if (row.Cells[1].Text == "ANATR")
{
e.Cancel = true;
MessageLabel.Text = "You cannot select " + row.Cells[2].Text + ".";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridView Select Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView Select Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="False"
autogenerateselectbutton="True"
selectedindex="1"
onselectedindexchanged="CustomersGridView_SelectedIndexChanged"
onselectedindexchanging="CustomersGridView_SelectedIndexChanging"
runat="server" DataKeyNames="CustomerID">
<Columns>
<asp:BoundField DataField="CustomerID"
HeaderText="CustomerID"
InsertVisible="False" ReadOnly="True"
SortExpression="CustomerID" />
<asp:BoundField DataField="FirstName"
HeaderText="FirstName"
SortExpression="FirstName" />
<asp:BoundField DataField="MiddleName"
HeaderText="MiddleName"
SortExpression="MiddleName" />
<asp:BoundField DataField="LastName"
HeaderText="LastName"
SortExpression="LastName" />
<asp:BoundField DataField="Phone"
HeaderText="Phone"
SortExpression="Phone" />
</Columns>
<selectedrowstyle backcolor="LightCyan"
forecolor="DarkBlue"
font-bold="true"/>
</asp:gridview>
<br/>
<asp:label id="MessageLabel"
forecolor="Red"
runat="server"/>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the 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, FirstName, MiddleName, LastName, Phone FROM SalesLT.Customer"
connectionstring="<%$ ConnectionStrings:AdventureWorksLTConnectionString %>"
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">
<script runat="server">
Sub CustomersGridView_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
' Get the currently selected row using the SelectedRow property.
Dim row As GridViewRow = CustomersGridView.SelectedRow
' Display the first name from the selected row.
' In this example, the third column (index 2) contains
' the first name.
MessageLabel.Text = "You selected " & row.Cells(2).Text & "."
End Sub
Sub CustomersGridView_SelectedIndexChanging(ByVal sender As Object, ByVal e As GridViewSelectEventArgs)
' Get the currently selected row. Because the SelectedIndexChanging event
' occurs before the select operation in the GridView control, the
' SelectedRow property cannot be used. Instead, use the Rows collection
' and the NewSelectedIndex property of the e argument passed to this
' event handler.
Dim row As GridViewRow = CustomersGridView.Rows(e.NewSelectedIndex)
' You can cancel the select operation by using the Cancel
' property. For this example, if the user selects a customer with
' the ID "ANATR", the select operation is canceled and an error message
' is displayed.
If row.Cells(1).Text = "ANATR" Then
e.Cancel = True
MessageLabel.Text = "You cannot select " + row.Cells(2).Text & "."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>GridView Select Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>GridView Select Example</h3>
<asp:gridview id="CustomersGridView"
datasourceid="CustomersSource"
autogeneratecolumns="False"
autogenerateselectbutton="True"
selectedindex="1"
onselectedindexchanged="CustomersGridView_SelectedIndexChanged"
onselectedindexchanging="CustomersGridView_SelectedIndexChanging"
runat="server" DataKeyNames="CustomerID">
<Columns>
<asp:BoundField DataField="CustomerID"
HeaderText="CustomerID"
InsertVisible="False" ReadOnly="True"
SortExpression="CustomerID" />
<asp:BoundField DataField="FirstName"
HeaderText="FirstName"
SortExpression="FirstName" />
<asp:BoundField DataField="MiddleName"
HeaderText="MiddleName"
SortExpression="MiddleName" />
<asp:BoundField DataField="LastName"
HeaderText="LastName"
SortExpression="LastName" />
<asp:BoundField DataField="Phone"
HeaderText="Phone"
SortExpression="Phone" />
</Columns>
<selectedrowstyle backcolor="LightCyan"
forecolor="DarkBlue"
font-bold="true"/>
</asp:gridview>
<br/>
<asp:label id="MessageLabel"
forecolor="Red"
runat="server"/>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the 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, FirstName, MiddleName, LastName, Phone FROM SalesLT.Customer"
connectionstring="<%$ ConnectionStrings:AdventureWorksLTConnectionString %>"
runat="server"/>
</form>
</body>
</html>
Hinweise
Wenn die AutoGenerateSelectButton Eigenschaft auf truefestgelegt ist, wird automatisch eine Spalte (dargestellt durch ein CommandField Objekt) mit einer Schaltfläche "Auswählen" für jede Datenzeile dem GridView Steuerelement hinzugefügt. Wenn Sie auf die Schaltfläche "Auswählen" für eine Zeile klicken, wird diese Zeile im Steuerelement ausgewählt, wodurch die SelectedIndex Eigenschaft auf den Index der Zeile festgelegt wird. Verwenden Sie die SelectedRow Eigenschaft, um das GridViewRow Objekt abzurufen, das die ausgewählte Zeile darstellt. Sie können auch den Primärschlüsselwert für den ausgewählten Datensatz mithilfe der SelectedValue Eigenschaft abrufen. Die SelectedValue Eigenschaft enthält die Werte der in der DataKeyNames Eigenschaft angegebenen Schlüsselfelder.
Hinweis
Sie können eine Zeile programmgesteuert auswählen, indem Sie die SelectedIndex Eigenschaft festlegen. Um die Auswahl einer Zeile abzubrechen, legen Sie die SelectedIndex Eigenschaft auf -1 fest.
Sie können die Darstellung der ausgewählten Zeile mithilfe der SelectedRowStyle Eigenschaft steuern. Allgemeine Einstellungen enthalten in der Regel eine benutzerdefinierte Hintergrundfarbe, Vordergrundfarbe und Schriftarteigenschaften.
Das GridView Steuerelement stellt mehrere Ereignisse bereit, mit denen Sie eine benutzerdefinierte Aktion ausführen können, wenn eine Zeile ausgewählt wird. In der folgenden Tabelle sind die verfügbaren Ereignisse aufgeführt.
| Ereignis | BESCHREIBUNG |
|---|---|
| SelectedIndexChanged | Tritt ein, wenn auf die Schaltfläche Auswählen einer Zeile geklickt wird, allerdings nachdem das GridView-Steuerelement den Auswahlvorgang behandelt hat. Dieses Ereignis wird häufig verwendet, um eine Aufgabe auszuführen, nachdem eine Zeile im Steuerelement ausgewählt wurde. |
| SelectedIndexChanging | Tritt ein, wenn auf die Schaltfläche Auswählen einer Zeile geklickt wird, allerdings bevor das GridView-Steuerelement den Auswahlvorgang behandelt. Dieses Ereignis wird häufig verwendet, um den Auswahlvorgang abzubrechen. |