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

SqlDataSource.ProviderName, propriété

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

Obtient ou définit le nom du fournisseur de données .NET Framework que le contrôle SqlDataSource utilise pour se connecter à une source de données sous-jacente.

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

public virtual string ProviderName { get; set; }
/** @property */
public String get_ProviderName ()

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

public function get ProviderName () : String

public function set ProviderName (value : String)

Valeur de la propriété

Nom du fournisseur de données utilisé par SqlDataSource ; sinon, fournisseur ADO.NET pour Microsoft SQL Server, si aucun fournisseur n'est défini. La valeur par défaut est le fournisseur ADO.NET pour Microsoft SQL Server.

Le .NET Framework inclut les fournisseurs des données suivants :

  • Le fournisseur System.Data.SqlClient est le fournisseur de données .NET Framework pour SQL Server par défaut.

  • Le fournisseur System.Data.OleDb est le fournisseur de données .NET Framework pour OLE DB.

  • Le fournisseur System.Data.Odbc est le fournisseur de données .NET Framework pour ODBC.

  • Le fournisseur System.Data.OracleClient est le fournisseur de données .NET Framework pour Oracle.

La propriété ProviderName n'a jamais la valeur d'un nom de fournisseur ADO.NET non managé, tel que MSDAORA. Pour plus d'informations, consultez Sélection de données à l'aide du contrôle SqlDataSource.

Si vous modifiez la propriété ProviderName, l'événement DataSourceChanged est déclenché et tous les contrôles liés au SqlDataSource sont à nouveau liés.

Une liste des fournisseurs disponibles est spécifiée dans la sous-section DbProviderFactories de la section system.data du fichier Machine.config.

Cette section comprend deux exemples de code. Le premier code illustre comment se connecter à une base de données SQL Server à l'aide du fournisseur de données .NET Framework pour SQL Server par défaut pour le contrôle SqlDataSource, System.Data.SqlClient. Le deuxième exemple de code illustre comment se connecter à une base de données ODBC à l'aide du fournisseur de données .NET Framework pour ODBC, System.Data.Odbc.

L'exemple de code suivant illustre comment se connecter à une base de données SQL Server à l'aide du fournisseur de données par défaut du contrôle SqlDataSource, System.Data.SqlClient. Chaque fois que la propriété ProviderName n'est pas définie explicitement, le fournisseur par défaut est utilisé. La propriété ConnectionString est spécifique au fournisseur.

<%@ Page language="CS" %>

<!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:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

    </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:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

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

L'exemple de code suivant qui fonctionne de la même façon que l'exemple précédent illustre comment se connecter à une base de données ODBC à l'aide du fournisseur de données .NET Framework pour ODBC, System.Data.Odbc. La propriété ConnectionString a la valeur d'un nom de source de données ODBC (DSN) utilisé pour se connecter à la base de données ODBC.

<!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"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT LastName FROM Employees;">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataSourceID="SqlDataSource1"
          DataTextField="LastName">
      </asp:ListBox>

    </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"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT LastName FROM Employees;">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataSourceID="SqlDataSource1"
          DataTextField="LastName">
      </asp:ListBox>

    </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
Afficher: