SqlDataSource.SelectCommand, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

Obtient ou définit la chaîne SQL que le contrôle SqlDataSource utilise pour récupérer des données de la base de données sous-jacente.

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

public string SelectCommand { get; set; }
/** @property */
public String get_SelectCommand ()

/** @property */
public void set_SelectCommand (String value)

public function get SelectCommand () : String

public function set SelectCommand (value : String)

Valeur de la propriété

Une chaîne SQL que SqlDataSource utilise pour récupérer des données.

Étant donné que les différents systèmes de base de données utilisent des variantes de langage SQL, la syntaxe de la chaîne SQL dépend du fournisseur ADO.NET utilisé, qui est identifié par la propriété ProviderName. Si la chaîne SQL est une requête ou une commande paramétrée, l'espace réservé du paramètre dépend également du fournisseur ADO.NET utilisé. Par exemple, si le fournisseur est System.Data.SqlClient, lequel est le fournisseur par défaut pour la classe SqlDataSource, l'espace réservé du paramètre est '@parameterName'. Toutefois, si le fournisseur a la valeur System.Data.Odbc ou System.Data.OleDb, l'espace réservé du paramètre est '?'. Pour plus d'informations sur les requêtes et les commandes SQL paramétrées, consultez Utilisation de paramètres avec le contrôle SqlDataSource.

La propriété SelectCommand peut être une chaîne SQL ou le nom d'une procédure stockée, si la source de données les prend en charge.

La propriété SelectCommand délègue à la propriété SelectCommand de l'objet SqlDataSourceView associé au contrôle SqlDataSource.

Remarque de sécuritéRemarque de sécurité

Pour des raisons de sécurité, la propriété SelectCommand n'est pas stockée dans l'état d'affichage. Étant donné qu'il est possible de décoder le contenu d'état d'affichage sur le client, le stockage d'informations sensibles relatives à la structure de base de données dans l'état d'affichage pourrait entraîner une faille dans la divulgation d'informations.

Cette section comprend deux exemples de code. Le premier exemple de code illustre comment définir le texte SelectCommand sur une requête SQL de base afin de récupérer des données d'une base de données ODBC et de les afficher dans un contrôle GridView. Le deuxième exemple de code montre comment définir le texte SelectCommand sur le nom d'une procédure stockée et la propriété SelectCommandType sur la valeur StoredProcedure pour récupérer des données d'une base de données Microsoft SQL Server et les afficher dans un contrôle DropDownList.

L'exemple de code suivant illustre comment définir le texte SelectCommand sur une requête SQL de base afin de récupérer des données d'une base de données ODBC et de les afficher dans un contrôle GridView.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->

    <FORM runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataSet"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </FORM>
  </BODY>
</HTML>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->

    <FORM runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataSet"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AllowSorting="True"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </FORM>
  </BODY>
</HTML>

L'exemple de code suivant montre comment définir le texte SelectCommand sur le nom d'une procédure stockée et la propriété SelectCommandType sur la valeur StoredProcedure pour récupérer des données d'une base de données SQL Server et les afficher dans un contrôle DropDownList. La propriété SelectCommand peut être une requête SQL ou le nom d'une procédure stockée, si la source de données les prend en charge.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
    <BODY>
        <FORM runat="server">

            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                DataTextField="LastName"
                DataSourceID="SqlDataSource1" />

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
                SelectCommandType="StoredProcedure"                
                SelectCommand="sp_lastnames">
            </asp:SqlDataSource>

            <!--
                The sp_lastnames stored procedure is
                CREATE PROCEDURE sp_lastnames AS
                   SELECT LastName FROM Employees
                GO
            -->

        </FORM>
    </BODY>
</HTML>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
    <BODY>
        <FORM runat="server">

            <asp:DropDownList
                id="DropDownList1"
                runat="server"
                DataTextField="LastName"
                DataSourceID="SqlDataSource1" />

            <asp:SqlDataSource
                id="SqlDataSource1"
                runat="server"
                ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
                SelectCommand="sp_lastnames">
            </asp:SqlDataSource>

            <!--
                The sp_lastnames stored procedure is
                CREATE PROCEDURE sp_lastnames AS
                   SELECT LastName FROM Employees
                GO
            -->

        </FORM>
    </BODY>
</HTML>

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher: