SqlDataSource.ProviderName プロパティ

.NET Framework クラス ライブラリ リファレンス

SqlDataSource.ProviderName プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

SqlDataSource コントロールが基になるデータ ソースに接続するために使用する .NET Framework データ プロバイダの名前を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 ProviderName As String

Visual Basic (使用法)

Dim instance As SqlDataSource
Dim value As String

value = instance.ProviderName

instance.ProviderName = value

C#

public virtual string ProviderName { get;
 set; }

C++

public:
virtual property String^ ProviderName {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_ProviderName ()

/** @property */
public void set_ProviderName (String value)

JScript

public function get ProviderName
 () : String

public function set ProviderName
 (value : String)

プロパティ値
SqlDataSource が使用するデータ プロバイダの名前。それ以外の場合、プロバイダが設定されていないときは、Microsoft SQL Server の ADO.NET プロバイダ。既定値は、Microsoft SQL Server の ADO.NET プロバイダです。

解説

.NET Framework には、次のデータ プロバイダが含まれています。

• System.Data.SqlClient プロバイダは、既定の .NET Framework SQL Server 用データ プロバイダです。

• System.Data.OleDb プロバイダは、.NET Framework OLE DB 用データ プロバイダです。

• System.Data.Odbc プロバイダは、.NET Framework ODBC 用データ プロバイダです。

• System.Data.OracleClient プロバイダは、.NET Framework Oracle 用データ プロバイダです。

ProviderName プロパティは、MSDAORA などのアンマネージ ADO.NET プロバイダの名前に設定されることはありません。詳細については、「SqlDataSource コントロールによるデータの選択」を参照してください。

ProviderName プロパティを変更すると、DataSourceChanged イベントが発生し、SqlDataSource にバインドされたコントロールがバインドし直されます。

使用できるプロバイダのリストは、Machine.config ファイルの system.data セクションの DbProviderFactories サブセクションで指定されます。

使用例

このセクションには、2 つのコード例が含まれています。1 つ目のコード例では、SqlDataSource コントロールの既定の .NET Framework SQL Server 用データ プロバイダ (System.Data.SqlClient) を使用して、SQL Server データベースに接続する方法を示します。2 つ目のコード例では、.NET Framework ODBC 用データ プロバイダ (System.Data.Odbc) を使用して、ODBC データベースに接続する方法を示します。

SqlDataSource コントロールの既定のデータ プロバイダ (System.Data.SqlClient) を使用して、SQL Server データベースに接続する方法を次のコード例に示します。ProviderName プロパティが明示的に設定されていない場合は、常に既定のプロバイダが使用されます。ConnectionString プロパティはプロバイダ固有です。

Visual Basic

<%@ Page language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM 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>

C#

<%@ Page language="CS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM 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>

J#

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<HTML>
  <BODY>
    <FORM runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="Data Source=localhost;Integrated Security=SSPI;Initial
 Catalog=Northwind;"
          SelectCommand="SELECT LastName FROM Employees">
      </asp:SqlDataSource>

      <asp:ListBox
          id="ListBox1"
          runat="server"
          DataTextField="LastName"
          DataSourceID="SqlDataSource1">
      </asp:ListBox>

    </FORM>
  </BODY>
</HTML>

.NET Framework ODBC 用データ プロバイダ (System.Data.Odbc) を使用して、ODBC データベースに接続する方法を次のコード例に示します。これは、前のコード例と機能的には同一です。ConnectionString プロパティは、ODBC データベースへの接続に使用される ODBC データ ソース名 (DSN) の名前に設定されます。

Visual Basic

<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML
 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

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

C#

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

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

J#

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
SqlDataSource クラス
SqlDataSource メンバ
System.Web.UI.WebControls 名前空間
SqlDataSource.ConnectionString プロパティ