SqlDataSource.ProviderName Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta il nome del provider di dati .NET Framework utilizzato dal controllo SqlDataSource per la connessione a un'origine dati sottostante.

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

Valore della proprietà

String

Nome del provider di dati utilizzato dall'oggetto SqlDataSource; in caso contrario, il provider ADO.NET per Microsoft SQL Server, se non è impostato alcun provider. Il valore predefinito è il provider ADO.NET per Microsoft SQL Server.

Attributi: TypeConverterAttribute

Esempio

In questa sezione sono riportati due esempi di codice. Il primo codice illustra come connettersi a un database SQL Server usando il System.Data.SqlClientprovider di dati .NET Framework predefinito per SQL Server per il SqlDataSource controllo . Il secondo esempio di codice illustra come connettersi a un database ODBC usando il provider di dati .NET Framework per ODBC, l'oggetto System.Data.Odbc.

Nell'esempio di codice seguente viene illustrato come connettersi a un database DI SQL Server usando il provider di dati predefinito per il controllo, l'oggetto SqlDataSource System.Data.SqlClient. Ogni volta che la ProviderName proprietà non è impostata in modo esplicito, viene usato il provider predefinito. La ConnectionString proprietà è specifica del provider.

<%@ 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'esempio di codice seguente, che è funzionalmente uguale all'esempio di codice precedente, illustra come connettersi a un database ODBC usando il provider di dati .NET Framework per ODBC, l'oggetto System.Data.Odbc. La ConnectionString proprietà è impostata sul nome di un nome origine dati ODBC (DSN) usato per connettersi al database 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>

Commenti

.NET Framework include i provider di dati seguenti:

Il System.Data.SqlClient provider è il provider di dati .NET Framework predefinito per SQL Server.
Il System.Data.OleDb provider è il provider di dati .NET Framework per OLE DB.
Il System.Data.Odbc provider è il provider di dati .NET Framework per ODBC.
Il System.Data.OracleClient provider è il provider di dati .NET Framework per Oracle.

La ProviderName proprietà non è mai impostata sul nome di un provider di ADO.NET non gestito, ad esempio MSDAORA. Per altre informazioni, vedere Selezione dei dati tramite il controllo SqlDataSource.

Se si modifica la proprietà, l'evento ProviderName DataSourceChanged viene generato, causando eventuali controlli associati all'oggetto SqlDataSource da associare.

Nell'elenco DbProviderFactories dei provider disponibili viene specificato nella sottosezione della system.data sezione del file di Machine.config.

Si applica a

Condividi tramite