OleDbConnectionStringBuilder.Item プロパティ

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

OleDbConnectionStringBuilder.Item プロパティ

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

指定したキーに関連付けられている値を取得または設定します。C# では、このプロパティはインデクサです。

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

Visual Basic (宣言)

Public Overrides Default
 Property Item ( _
    keyword As String _
) As Object

Visual Basic (使用法)

Dim instance As OleDbConnectionStringBuilder
Dim keyword As String
Dim value As Object

value = instance(keyword)

instance(keyword) = value

C#

public override Object this [
    string keyword
] { get; set; }

C++

public:
virtual property Object^ default [String^] {
    Object^ get (String^ keyword) override;
    void set (String^ keyword, Object^ value)
 override;
}

J#

/** @property */
public Object get_Item (String keyword)

/** @property */
public void set_Item (String keyword, Object
 value)

JScript

JScript では、インデックス付きのプロパティは使用できますが、新規に宣言することはできません。.

パラメータ

keyword

取得または設定する項目のキー。

プロパティ値
指定したキーに関連付けられている値。

例外

例外の種類	条件
ArgumentException	接続文字列が正しい書式になっていません。たとえば、キー/値ペアに "=" が欠落していることが考えられます。
ArgumentNullException	keyword が null 参照 (Visual Basic の場合は Nothing) です。

解説

Provider プロパティを設定すると、プロバイダによっては、キー/値ペアのコレクションに対応する項目が追加されるため、明示的には設定しなかったキーの値を取得できることがあります。たとえば、Provider プロパティを "sqloledb" に設定すると、明示的に指定しなくても、"Workstation ID" 値を取得できるようになります。実際の例については、このトピックに示したコードを参照してください。

使用例

次の例では、Item プロパティ (C# ではインデクサ) を使用して、キー/値ペアのコレクションの値を取得および設定しています。また、この場合、プロバイダを設定すると、選択したプロバイダに関連付けられている、すべてのキー/値ペアの既定値が提供される点に注意してください。

Visual Basic

Imports System.Data.OleDb    

Module Module1
  Sub Main()
    Dim builder As New OleDbConnectionStringBuilder
    builder.Provider = "Microsoft.Jet.Oledb.4.0"
    builder.DataSource = "C:\Sample.mdb"
    ' Set properties using the Item property.
    builder.Item("Jet OLEDB:Database Password") =
 "DataPassword"
    builder.Item("Jet OLEDB:Encrypt Database") = True

    ' Because Item is the default property, you can leave out
    ' the explicit reference.
    builder("Jet OLEDB:System database") = "C:\Workgroup.mdw"

    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()

    ' Use the Item property to retrieve values, as well.
    Console.WriteLine(builder.Item("Jet OLEDB:System database"))
    Console.WriteLine(builder("Jet OLEDB:Encrypt Database"))

    ' You can set or retrieve any of the "default" values
 for the 
    ' provider, as well, even if you did not set their values. Again,
 
    ' explicitly specifying the Item property name is optional.
    Console.WriteLine(builder.Item("Jet OLEDB:Database Locking
 Mode"))
    Console.WriteLine(builder("Jet OLEDB:Global Partial Bulk Ops"))

    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
  End Sub
End Module

C#

using System.Data.OleDb;

class Program
{
    static void Main()
    {
        OleDbConnectionStringBuilder builder = new OleDbConnectionStringBuilder();
        builder.Provider = "Microsoft.Jet.Oledb.4.0";
        builder.DataSource = @"C:\Sample.mdb";
        // Set properties using the Item property (the indexer, in C#).
        builder["Jet OLEDB:Database Password"] = "DataPassword";
        builder["Jet OLEDB:Encrypt Database"] = true;
        builder["Jet OLEDB:System database"] = @"C:\Workgroup.mdw";

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();

        // Use the Item property to retrieve values as well.
        Console.WriteLine(builder["Jet OLEDB:System database"]);
        Console.WriteLine(builder["Jet OLEDB:Encrypt Database"]);

        // You can set or retrieve any of the "default" values
 for the 
        // provider, even if you didn't set their values.
        Console.WriteLine(builder["Jet OLEDB:Database Locking Mode"]);
        Console.WriteLine(builder["Jet OLEDB:Global Partial Bulk Ops"]);

        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();

    }
}

プラットフォーム

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
接続文字列の使用