GridView.SelectedValue 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 den Datenschlüsselwert der ausgewählten Zeile in einem GridView-Steuerelement ab.

public:
 property System::Object ^ SelectedValue { System::Object ^ get(); };

[System.ComponentModel.Browsable(false)]
public object SelectedValue { get; }

[<System.ComponentModel.Browsable(false)>]
member this.SelectedValue : obj

Public ReadOnly Property SelectedValue As Object

Eigenschaftswert

Object

Der Datenschlüsselwert der ausgewählten Zeile in einem GridView-Steuerelement.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie die SelectedValue -Eigenschaft verwendet wird, um den Datenschlüsselwert der ausgewählten Zeile in einem GridView Steuerelement zu bestimmen.


<%@ 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)  
  {
        
    // Display the primary key value of the selected row.
    Message.Text = "The primary key value of the selected row is " +
      CustomersGridView.SelectedValue.ToString() + ".";
    
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView SelectedValue Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView SelectedValue Example</h3>
            
      <asp:label id="Message"
        forecolor="Red"
        runat="server"/>
                
      <br/><br/>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        allowpaging="true"
        autogeneratecolumns="true"
        autogenerateselectbutton="true"    
        datakeynames="CustomerID"
        onselectedindexchanged="CustomersGridView_SelectedIndexChanged"   
        runat="server">
                
        <selectedrowstyle backcolor="LightBlue"
          forecolor="DarkBlue"/> 
               
      </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">
<script runat="server">

  Sub CustomersGridView_SelectedIndexChanged(ByVal sender As Object, ByVal e As EventArgs)
        
    ' Display the primary key value of the selected row.
    Message.Text = "The primary key value of the selected row is " & _
      CustomersGridView.SelectedValue.ToString() & "."
    
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>GridView SelectedValue Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>GridView SelectedValue Example</h3>
            
      <asp:label id="Message"
        forecolor="Red"
        runat="server"/>
                
      <br/><br/>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        allowpaging="true"
        autogeneratecolumns="true"
        autogenerateselectbutton="true"    
        datakeynames="CustomerID"
        onselectedindexchanged="CustomersGridView_SelectedIndexChanged"   
        runat="server">
                
        <selectedrowstyle backcolor="LightBlue"
          forecolor="DarkBlue"/> 
               
      </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

Wenn die DataKeyNames -Eigenschaft mit einer durch Trennzeichen getrennten Liste von Feldnamen festgelegt wird, die den Primärschlüssel der Datenquelle darstellen, erstellt das GridView Steuerelement automatisch ein DataKey -Objekt für jede Zeile im Steuerelement unter Verwendung des Werts oder der Werte des angegebenen Felds oder der angegebenen Felder. Die DataKey -Objekte werden dann der -Auflistung des Steuerelements DataKeys hinzugefügt. Normalerweise wird die DataKeys -Eigenschaft verwendet, um das DataKey -Objekt für eine bestimmte Datenzeile im GridView Steuerelement abzurufen. Wenn Sie jedoch nur das DataKey Objekt der aktuell ausgewählten Zeile abrufen müssen, können Sie die SelectedDataKey -Eigenschaft einfach als Verknüpfung verwenden. Als weitere Verknüpfung können Sie den Datenschlüsselwert des ersten Schlüsselfelds der ausgewählten Zeile mithilfe der SelectedValue -Eigenschaft direkt ermitteln.

Wenn Sie ein ControlParameter -Objekt erstellen und auf ein anderes Schlüsselfeld als das erste Feld zugreifen möchten, verwenden Sie die SelectedDataKey -Eigenschaft. Ein Beispiel finden Sie unter SelectedDataKey.

Gilt für:

Freigeben über