Cette documentation est archivée et n’est pas conservée.

GridView.SelectedValue, propriété

Obtient la valeur de clés des données de la ligne sélectionnée dans un contrôle GridView.

Espace de noms: System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public Object SelectedValue { get; }
/** @property */
public Object get_SelectedValue ()

public function get SelectedValue () : Object

Non applicable.

Valeur de la propriété

Valeur de clés des données de la ligne sélectionnée dans un contrôle GridView.

Lorsque la propriété DataKeyNames est définie avec une liste avec la virgule comme séparateur des noms de champs qui représentent la clé primaire de la source de données, le contrôle GridView crée automatiquement un objet DataKey pour chaque ligne du contrôle à l'aide de la ou des valeurs du ou des champs spécifiés. Les objets DataKey sont ensuite ajoutés à la collection DataKeys du contrôle. Normalement, la propriété DataKeys est utilisée pour récupérer l'objet DataKey pour une ligne de données spécifique du contrôle GridView. Toutefois, si vous devez simplement récupérer l'objet DataKey de la ligne actuellement sélectionnée, vous pouvez utiliser la propriété SelectedDataKey comme un raccourci. De plus, vous pouvez déterminer comme raccourci supplémentaire directement la valeur de clés des données du premier champ clé de la ligne sélectionnée à l'aide de la propriété SelectedValue.

Si vous créez un objet ControlParameter et souhaitez accéder à un champ clé autre que le premier champ, utilisez la propriété SelectedDataKey. Pour obtenir un exemple, consultez SelectedDataKey.

L'exemple suivant montre comment utiliser la propriété SelectedValue pour déterminer la valeur de clé des données de la ligne sélectionnée dans le contrôle GridView.


<%@ 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>


Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0
Afficher: