Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Proprietà PropertyCollection.IDictionary.Item (Object)

 

Data di pubblicazione: ottobre 2016

Ottiene o imposta l'elemento con la chiave specificata.

Spazio dei nomi:   System.DirectoryServices
Assembly:  System.DirectoryServices (in System.DirectoryServices.dll)

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

Parametri

key
Type: System.Object

Chiave dell'elemento da ottenere o impostare.

Valore proprietà

Type: System.Object

Elemento con la chiave specificata.

Exception Condition
ArgumentNullException

key è null.

NotSupportedException

La proprietà è impostata e IDictionary oggetto è di sola lettura.

-oppure-

La proprietà è impostata, key non esiste nella raccolta e il IDictionary ha dimensioni fisse.

Questa proprietà consente di accedere a un elemento specifico della raccolta utilizzando la sintassi seguente: myCollection[key].

È inoltre possibile utilizzare il Item proprietà per aggiungere nuovi elementi impostando il valore di una chiave non esiste nel dizionario (ad esempio, myCollection["myNonexistentKey"] = myValue). Tuttavia, se la chiave specificata esiste già nel dizionario, impostando il Item proprietà sovrascrive il vecchio valore. Al contrario, il Add metodo non modifica gli elementi esistenti.

Nell'esempio seguente viene illustrato come implementare il Item proprietà. Questo esempio di codice fa parte di un esempio più esaustivo fornito per la IDictionary classe.

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

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: