SqlDataSource.ProviderName Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia nazwę dostawcy danych .NET Framework, którego SqlDataSource kontrolka używa do nawiązywania połączenia z bazowym źródłem danych.

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

Wartość właściwości

String

Nazwa dostawcy danych, którego SqlDataSource używa; w przeciwnym razie dostawca ADO.NET dla firmy Microsoft SQL Server, jeśli nie ustawiono dostawcy. Wartość domyślna to dostawca ADO.NET dla SQL Server firmy Microsoft.

Atrybuty: TypeConverterAttribute

Przykłady

Ten rozdział zawiera dwa przykłady kodu. Pierwszy kod pokazuje, jak nawiązać połączenie z bazą danych SQL Server przy użyciu domyślnego dostawcy danych .NET Framework dla SQL Server dla kontrolki SqlDataSource .System.Data.SqlClient Drugi przykład kodu pokazuje, jak nawiązać połączenie z bazą danych ODBC przy użyciu dostawcy danych .NET Framework dla ODBC.System.Data.Odbc

Poniższy przykład kodu pokazuje, jak nawiązać połączenie z bazą danych SQL Server przy użyciu domyślnego dostawcy danych dla kontrolki SqlDataSource .System.Data.SqlClient Zawsze, ProviderName gdy właściwość nie jest jawnie ustawiona, jest używany domyślny dostawca. Właściwość jest specyficzna ConnectionString dla dostawcy.

<%@ 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>

Poniższy przykład kodu, który jest funkcjonalnie taki sam jak w poprzednim przykładzie kodu, pokazuje, jak nawiązać połączenie z bazą danych ODBC przy użyciu dostawcy danych .NET Framework dla ODBC.System.Data.Odbc Właściwość ConnectionString jest ustawiona na nazwę nazwy źródła danych ODBC (DSN), która jest używana do nawiązywania połączenia z bazą danych 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>

Uwagi

.NET Framework obejmuje następujących dostawców danych:

Dostawca System.Data.SqlClient jest domyślnym dostawcą danych .NET Framework dla SQL Server.
Dostawca System.Data.OleDb jest dostawcą danych .NET Framework dla OLE DB.
Dostawca System.Data.Odbc jest dostawcą .NET Framework data provider for ODBC.
Dostawca System.Data.OracleClient jest dostawcą .NET Framework data provider for Oracle.

Właściwość ProviderName nigdy nie jest ustawiona na nazwę niezarządzanego dostawcy ADO.NET, takiego jak MSDAORA. Aby uzyskać więcej informacji, zobacz Wybieranie danych przy użyciu kontrolki SqlDataSource.

Jeśli zmienisz ProviderName właściwość, DataSourceChanged zdarzenie zostanie podniesione, powodując wszystkie kontrolki powiązane z elementem do ponownego SqlDataSource powiązania.

Lista dostępnych dostawców jest określona w DbProviderFactories podsekcji system.data sekcji pliku Machine.config.

Dotyczy

SqlDataSource.ProviderName Właściwość

Definicja

Wartość właściwości

Przykłady

Uwagi

Dotyczy

Zobacz też

Opinia

Dodatkowe zasoby