OdbcConnectionStringBuilder.Item プロパティ

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

OdbcConnectionStringBuilder.Item プロパティ

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

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

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

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As OdbcConnectionStringBuilder
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) です。

解説

このプロパティを設定すると、指定したキーがディクショナリに既に存在する場合は、その値が置換されます。それ以外の場合は、新しい要素が作成されます。

使用例

次のコンソール アプリケーションでは、新しい OdbcConnectionStringBuilder を作成し、Item プロパティを使用してキー/値ペアを接続文字列に追加しています。

Visual Basic

Imports System.Data.Odbc    

Module Module1
  Sub Main()
    Dim builder As New OdbcConnectionStringBuilder
    ' Set up a connection string for a text file.
    builder.Item("Driver") = "Microsoft
 Text Driver (*.txt; *.csv)"
    ' Note that Item is the default property, so 
    ' you need not include it in the reference.
    builder("dbq") = "C:\TextFilesFolder"
    builder.Item("Extension") = "asc
,csv,tab,txt"

    ' Overwrite the existing value for the dbq value, 
    ' because it already exists within the collection.
    builder.Item("dbq") = "D:\"

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

C#

using System.Data.Odbc;


class Program
{
    static void Main()
    {
        OdbcConnectionStringBuilder builder = 
            new OdbcConnectionStringBuilder();
        // Set up a connection string for a text file.
        builder["Driver"] = "Microsoft Text Driver (*.txt; *.csv)";
        builder["dbq"] = "C:\\TextFilesFolder";
        builder["Extension"] = "asc,csv,tab,txt";

        // Overwrite the existing value for the dbq value, 
        // because it already exists within the collection.
        builder["dbq"] = "D:\\";

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();
        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

参照

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