PropertyCollection.System.Collections.IDictionary.Item プロパティ

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

PropertyCollection.System.Collections.IDictionary.Item プロパティ

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

指定したキーを持つ要素を取得または設定します。

名前空間: System.DirectoryServices
アセンブリ: System.DirectoryServices (system.directoryservices.dll 内)
構文

Visual Basic (宣言)

Private Property System.Collections.IDictionary.Item
 ( _
    key As Object _
) As Object Implements IDictionary.Item

Visual Basic (使用法)

Dim instance As PropertyCollection
Dim key As Object
Dim value As Object

value = CType(instance, IDictionary).Item(key)

CType(instance, IDictionary).Item(key) = value

C#

Object IDictionary.this [
    Object key
] { get; set; }

C++

private:
virtual property Object^ System.Collections.IDictionary.Item [Object^] {
    Object^ get (Object^ key) sealed = IDictionary::default::get;
    void set (Object^ key, Object^ value) sealed
 = IDictionary::default::set;
}

J#

J# では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

JScript

JScript では、明示的なインタフェースの実装は使用できますが、新規に宣言することはできません。

パラメータ

key

取得または設定する要素のキー。

プロパティ値
指定したキーを持つ要素。

例外

例外の種類	条件
ArgumentNullException	key が null 参照 (Visual Basic では Nothing) です。
NotSupportedException	このプロパティが設定されていますが、IDictionary オブジェクトが読み取り専用です。 または このプロパティが設定されていますが、key がコレクション内に存在しません。また、IDictionary が固定サイズです。

解説

このプロパティでは、myCollection[key] という構文を使用して、コレクション内の特定の要素にアクセスできます。

Item プロパティを使用すると、ディクショナリ内に存在しないキーの値を設定することで、新しい要素を追加することもできます (例 : myCollection["myNonexistentKey"] = myValue)。ただし、指定したキーがディクショナリに既に存在する場合、Item プロパティを設定すると、既存の値が上書きされます。対照的に、Add メソッドは既存の要素を変更しません。

使用例

Item プロパティを実装する方法の例を次に示します。このコード例は、IDictionary クラスのトピックで取り上げているコード例の一部です。

Visual Basic

Public Property Item(ByVal
 key As Object) As Object
 Implements IDictionary.Item
    Get

        ' If this key is in the dictionary, return its value.
        Dim index As Integer
        If TryGetIndexOfKey(key, index) Then

            ' The key was found return its value.
            Return items(index).Value
        Else

            ' The key was not found return null.
            Return Nothing
        End If
    End Get

    Set(ByVal value As Object)
        ' If this key is in the dictionary, change its value. 
        Dim index As Integer
        If TryGetIndexOfKey(key, index) Then

            ' The key was found change its value.
            items(index).Value = value
        Else

            ' This key is not in the dictionary add this key/value pair.
            Add(key, value)
        End If
    End Set
End Property

C#

public object this[object key]
{
    get
    {   
        // If this key is in the dictionary, return its value.
        Int32 index;
        if (TryGetIndexOfKey(key, out index))
        {
            // The key was found; return its value.
            return items[index].Value;
        } 
        else
        {
            // The key was not found; return null.
            return null;
        }
    }

    set
    {
        // If this key is in the dictionary, change its value. 
        Int32 index;
        if (TryGetIndexOfKey(key, out index))
        {
            // The key was found; change its value.
            items[index].Value = value;
        } 
        else
        {
            // This key is not in the dictionary; add this key/value
 pair.
            Add(key, value);
        }
    }
}

C++

public:
    virtual property Object^ default[Object^]
    {
        Object^ get(Object^ key)
        {
            // If this key is in the dictionary, return its value.
            int index;
            if (TryGetIndexOfKey(key, &index))
            {
                // The key was found; return its value.
                return items[index]->Value;
            }
            else
            {
                // The key was not found; return null.
                return nullptr;
            }
        }

        void set(Object^ key, Object^ value)
        {
            // If this key is in the dictionary, change its value.
            int index;
            if (TryGetIndexOfKey(key, &index))
            {
                // The key was found; change its value.
                items[index]->Value = value;
            }
            else
            {
                // This key is not in the dictionary; add this
                // key/value pair.
                Add(key, value);
            }
        }
    }

プラットフォーム

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

参照

関連項目
PropertyCollection クラス
PropertyCollection メンバ
System.DirectoryServices 名前空間
Add