PropertyCollection.IDictionary.Item[Object] Vlastnost

Definice

Obor názvů:

System.DirectoryServices

Sestavení:

System.DirectoryServices.dll

Balíček:

System.DirectoryServices v8.0.0

Zdroj:

PropertyCollection.cs

Získá nebo nastaví element se zadaným klíčem.

property System::Object ^ System::Collections::IDictionary::Item[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };

object? System.Collections.IDictionary.Item[object key] { get; set; }

member this.System.Collections.IDictionary.Item(obj) : obj with get, set

 Property Item(key As Object) As Object Implements IDictionary.Item

Parametry

key

Object

Klíč elementu, který chcete získat nebo nastavit.

Hodnota vlastnosti

Object

Element se zadaným klíčem.

Implementuje

Item[Object]

Výjimky

ArgumentNullException

key je null.

NotSupportedException

Vlastnost je nastavena IDictionary a objekt je jen pro čtení.

-nebo-

Vlastnost je nastavená, key v kolekci neexistuje a IDictionary má pevnou velikost.

Příklady

Následující příklad ukazuje, jak implementovat Item[] vlastnost. Tento příklad kódu je součástí většího příkladu IDictionary pro třídu.

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);
            }
        }
    }

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);
        }
    }
}

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

Poznámky

Tato vlastnost poskytuje možnost přístupu ke konkrétnímu prvku v kolekci pomocí následující syntaxe: myCollection[key].

Vlastnost můžete také použít Item[] k přidání nových prvků nastavením hodnoty klíče, který ve slovníku neexistuje (například myCollection["myNonexistentKey"] = myValue). Pokud však zadaný klíč již ve slovníku existuje, nastavení Item[] vlastnosti přepíše starou hodnotu. Naproti tomu Add metoda neupravuje existující prvky.

Viz také

• Add(Object, Object)