SqlDataSource.ProviderName Propriété
Définition
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, setPublic Overridable Property ProviderName As StringValeur de 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.
- 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 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 explicitement définie, 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 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 inclut 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 réassociation des contrôles liés à .SqlDataSource
Une liste des fournisseurs disponibles est spécifiée dans la DbProviderFactories sous-section de la system.data section du fichier Machine.config.
S’applique à
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour