SqlDataSource.ProviderName Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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: TypeConverterAttribute

Exemples

Cette section contient deux exemples de code. Le premier code montre comment se connecter à une base de données SQL Server à l’aide du fournisseur de données .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 du fournisseur de données .NET Framework 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 propre 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 est fonctionnellement identique à l’exemple de code précédent, montre comment se connecter à une base de données ODBC à l’aide du fournisseur de données .NET Framework pour ODBC, le System.Data.Odbc. La ConnectionString propriété est définie sur le nom 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 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 fournisseur de données .NET Framework par défaut 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 fournisseur de données .NET Framework pour ODBC.
Le System.Data.OracleClient fournisseur est le fournisseur de données .NET Framework pour Oracle.

La ProviderName propriété n’est jamais définie sur le nom d’un fournisseur de 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’événement DataSourceChanged est déclenché, ce qui entraîne la reliure de tous les contrôles liés au SqlDataSource .

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

S’applique à

Partager via