PropertyCollection.IDictionary.Item[Object] Propriété

Référence

Définition

Espace de noms:: System.DirectoryServices

Assembly:: System.DirectoryServices.dll

Paquet:: System.DirectoryServices v6.0.0

Paquet:: System.DirectoryServices v7.0.0

Paquet:: System.DirectoryServices v8.0.0

Paquet:: System.DirectoryServices v9.0.0-preview.2.24128.5

Source:: PropertyCollection.cs

Source:: PropertyCollection.cs

Source:: PropertyCollection.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit l'élément à l'aide de la clé spécifiée.

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

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

Paramètres

key: Object

Clé de l'élément à obtenir ou définir.

Valeur de propriété

Object

Élément correspondant à la clé spécifiée.

Implémente

Item[Object]

Exceptions

ArgumentNullException

key a la valeur null.

NotSupportedException

La propriété est définie et l'objet IDictionary est en lecture seule.

- ou -

La propriété est définie, key n’existe pas dans la collection et IDictionary a une taille fixe.

Exemples

L’exemple suivant montre comment implémenter la Item[] propriété. Cet exemple de code fait partie d’un exemple plus grand fourni pour la IDictionary classe .

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

Remarques

Cette propriété permet d'accéder à un élément spécifique dans la collection à l'aide de la syntaxe suivante : myCollection[key].

Vous pouvez également utiliser la Item[] propriété pour ajouter de nouveaux éléments en définissant la valeur d’une clé qui n’existe pas dans le dictionnaire (par exemple, myCollection["myNonexistentKey"] = myValue). Toutefois, si la clé spécifiée existe déjà dans le dictionnaire, la définition de la Item[] propriété remplace l’ancienne valeur. En revanche, la Add méthode ne modifie pas les éléments existants.

S’applique à

Produit	Versions
.NET Framework	2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5, 6, 7, 8, 9

Voir aussi

Add(Object, Object)

Partager via