SqlDataSource.ProviderName Propriété

Définition

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.

public:
 virtual property System::String ^ ProviderName { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.DataProviderNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string ProviderName { get; set; }
[System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.DataProviderNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public virtual string ProviderName { get; set; }
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.DataProviderNameConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ProviderName : string with get, set
[<System.ComponentModel.TypeConverter("System.Web.UI.Design.WebControls.DataProviderNameConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ProviderName : string with get, set
Public Overridable Property ProviderName As String

Valeur de propriété

String

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.

Attributs

Exemples

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

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

<%@ Page language="C#" %>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" 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>
<%@ Page language="VB" %>

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

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" 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>

L’exemple de code suivant, qui fonctionne de la même façon que l’exemple de code précédent, montre comment se connecter à une base de données ODBC à l’aide de la .NET Framework Fournisseur de données pour ODBC, le System.Data.Odbc . La ConnectionString propriété est définie sur le nom d’un nom de source de données (DSN) ODBC 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 xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<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 id="form1" 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>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<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 id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          ConnectionString="dsn=myodbc3-test;"
          SelectCommand="SELECT LastName FROM Employees;">
      </asp:SqlDataSource>

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

    </form>
  </body>
</html>

Remarques

Le .NET Framework comprend les fournisseurs de données suivants :

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

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

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

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

La ProviderName propriété n’a jamais la valeur du nom d’un 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 ProviderName propriété, l' DataSourceChanged événement est déclenché, ce qui entraîne la reliaison de tous les contrôles liés au SqlDataSource .

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

S’applique à

Voir aussi