SqlDataSource.ProviderName Özellik

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Denetimin temel alınan bir veri kaynağına bağlanmak için kullandığı .NET Framework veri sağlayıcısının SqlDataSource adını alır veya ayarlar.

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

Özellik Değeri

String

Kullandığı veri sağlayıcısının SqlDataSource adı; aksi takdirde, sağlayıcı ayarlı değilse Microsoft SQL Server için ADO.NET sağlayıcısı. Varsayılan değer, Microsoft SQL Server için ADO.NET sağlayıcısıdır.

Öznitelikler: TypeConverterAttribute

Örnekler

Bu bölüm iki kod örneği içerir. İlk kod, denetimi için SQL Server için varsayılan .NET Framework Veri Sağlayıcısı 'nı kullanarak bir SQL Server SqlDataSource veritabanına nasıl bağlanacaklarını System.Data.SqlClientgösterir. İkinci kod örneğinde ODBC için .NET Framework Veri Sağlayıcısı'nı kullanarak odbc veritabanına nasıl bağlandığınız gösterilmektedir System.Data.Odbc.

Aşağıdaki kod örneği, denetimi için SqlDataSource varsayılan veri sağlayıcısı olan kullanarak bir SQL Server veritabanına nasıl bağlanacaklarını System.Data.SqlClientgösterir. ProviderName Özellik açıkça ayarlanmadığı her durumda varsayılan sağlayıcı kullanılır. ConnectionString özelliği sağlayıcıya özgüdür.

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

Yukarıdaki kod örneğiyle işlevsel olarak aynı olan aşağıdaki kod örneği, ODBC için .NET Framework Veri Sağlayıcısı'nı kullanarak bir ODBC veritabanına bağlanmayı System.Data.Odbcgösterir. ConnectionString özelliği, ODBC veritabanına bağlanmak için kullanılan odbc veri kaynağı adının (DSN) adına ayarlanır.

<!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>

Açıklamalar

.NET Framework aşağıdaki veri sağlayıcılarını içerir:

Sağlayıcı System.Data.SqlClient , SQL Server için varsayılan .NET Framework Veri Sağlayıcısıdır.
Sağlayıcı System.Data.OleDb , OLE DB için .NET Framework Veri Sağlayıcısıdır.
Sağlayıcı System.Data.Odbc , ODBC için .NET Framework Veri Sağlayıcısıdır.
Sağlayıcı System.Data.OracleClient , Oracle için .NET Framework Veri Sağlayıcısıdır.

ProviderName özelliği hiçbir zaman gibi MSDAORAyönetilmeyen bir ADO.NET sağlayıcısının adına ayarlanmamıştır. Daha fazla bilgi için bkz. SqlDataSource Denetimini Kullanarak Veri Seçme.

özelliğini değiştirirseniz ProviderName , DataSourceChanged olayı oluşturulur ve yeniden bağlamaya SqlDataSource bağlı denetimlere neden olur.

Kullanılabilir sağlayıcıların listesi, Machine.config dosyasının bölümünün alt system.data bölümünde belirtilirDbProviderFactories.

Şunlara uygulanır

Aracılığıyla paylaş