Udostępnij za pośrednictwem


SqlDataSource.ProviderName Właściwość

Definicja

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

Nazwa dostawcy danych używanego SqlDataSource przez dostawcę, w przeciwnym razie dostawca ADO.NET dla programu Microsoft SQL Server, jeśli nie ustawiono żadnego dostawcy. Wartość domyślna to dostawca ADO.NET dla programu Microsoft SQL Server.

Atrybuty

Przykłady

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

Poniższy przykład kodu pokazuje, jak nawiązać połączenie z bazą danych programu 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 programu .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

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

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

Zobacz też