OleDbConnectionStringBuilder.Provider プロパティ

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

OleDbConnectionStringBuilder.Provider プロパティ

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

接続文字列に関連付けられたデータ プロバイダの名前を内部的に保持する文字列を取得または設定します。

名前空間: System.Data.OleDb
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Property Provider As
 String

Visual Basic (使用法)

Dim instance As OleDbConnectionStringBuilder
Dim value As String

value = instance.Provider

instance.Provider = value

C#

public string Provider { get;
 set; }

C++

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

J#

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

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

JScript

public function get Provider
 () : String

public function set Provider
 (value : String)

プロパティ値
Provider プロパティの値。何も指定されていない場合は String.Empty。

解説

プロパティを設定するときに渡された値が null の場合、Provider プロパティはリセットされます。値が設定されていない場合に開発者がプロパティを取得しようとすると、String.Empty が返されます。このプロパティは、接続文字列内の "Provider" キーに対応します。

Provider プロパティの値を設定すると、直接 ConnectionString プロパティを設定するか、接続文字列をパラメータとしてコンストラクタに渡すかにかかわらず、OleDbConnectionStringBuilder インスタンス内に保持されるキー/値ペアに影響を与えます。たとえば、Provider プロパティを "sqloledb" に設定すると、標準的な SQL 接続文字列のプロパティがすべて追加されます。実際の例については、このトピックに示したコードを参照してください。

プロバイダによっては、OleDbConnectionStringBuilder コンストラクタ内に接続文字列を割り当てると、指定したキー/値ペアの順序が変更される場合があります。

使用例

次の例では、複数の OleDbConnectionStringBuilder インスタンスを作成し、それぞれの場合について異なる接続文字列をコンストラクタに渡しています。接続に使用するプロバイダを設定することによって、定義済みのキー/値ペアが、オブジェクトのコレクション内でどのように変わるかに注意してください。

メモ
この例には、OleDbConnectionStringBuilder と接続文字列がどのように連携するかを示すパスワードが含まれています。アプリケーションでは、Windows 認証の使用をお勧めします。パスワードを使用する必要がある場合は、ハードコーディングされたパスワードをアプリケーションに組み込まないでください。

Visual Basic

Imports System.Data.OleDb    

Module Module1
  Sub Main()
    Try
      ' Build an empty instance, just to see
      ' the contents of the keys.
      DumpBuilderContents("")

      ' Create a SQL Server connection string.
      DumpBuilderContents("Provider=sqloledb;Data Source=(local);"
 & _
       "Initial Catalog=AdventureWorks;" & _
       "User Id=ab;Password=Password@1")

      ' Create an Access connection string.
      DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;"
 & _
       "Data Source=C:\Sample.mdb")

      ' Create an Oracle connection string.
      DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;"
 & _
       "User Id=userName;Password=Pass@word1;")

      ' Create a Sybase connection string.
      DumpBuilderContents("Provider=ASAProv;Data source=myASA")

      Console.WriteLine("Press any key to finish.")
      Console.ReadLine()

    Catch ex As System.ArgumentException
      Console.WriteLine("Error: " & ex.Message)
    End Try
  End Sub

  Private Sub DumpBuilderContents(ByVal
 connectString As String)
    Dim builder As New OleDbConnectionStringBuilder(connectString)
    Console.WriteLine("=================")
    Console.WriteLine("Original connectString   = "
 & connectString)
    Console.WriteLine("builder.ConnectionString = "
 & builder.ConnectionString)
    For Each key As String
 In builder.Keys
      Console.WriteLine(key & "=" & builder.Item(key).ToString)
    Next
  End Sub
End Module

C#

using System.Data.OleDb;

class Program
{
    static void Main()
    {
        try
        {
            // Build an empty instance, just to see
            // the contents of the keys.
            DumpBuilderContents("");

            // Create a SQL Server connection string.
            DumpBuilderContents("Provider=sqloledb;Data Source=(local);"
 +
                "Initial Catalog=AdventureWorks;" +
                "User Id=ab;Password=Password@1");

            // Create an Access connection string.
            DumpBuilderContents("Provider=Microsoft.Jet.OLEDB.4.0;" +
                @"Data Source=C:\Sample.mdb");

            // Create an Oracle connection string.
            DumpBuilderContents("Provider=msdaora;Data Source=SomeOracleDb;"
 +
                "User Id=userName;Password=Pass@word1;");

            // Create a Sybase connection string.
            DumpBuilderContents("Provider=ASAProv;Data source=myASA");

            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (System.ArgumentException ex)
        {

            Console.WriteLine("Error: " + ex.Message);
        }
    }

    private static void
 DumpBuilderContents(string connectString)
    {
        OleDbConnectionStringBuilder builder =
            new OleDbConnectionStringBuilder(connectString);
        Console.WriteLine("=================");
        Console.WriteLine("Original connectString   = " + connectString);
        Console.WriteLine("builder.ConnectionString = " + builder.ConnectionString);
        foreach (string key in
 builder.Keys)
        {
            Console.WriteLine(key + "=" + builder[key].ToString());
        }
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

関連項目
OleDbConnectionStringBuilder クラス
OleDbConnectionStringBuilder メンバ
System.Data.OleDb 名前空間
その他の技術情報
Building Connection Strings
接続文字列の使用