OrderedDictionary.Item[] Propiedad

Definición

Espacio de nombres:

System.Collections.Specialized

Ensamblado:

System.Collections.Specialized.dll

Obtiene o establece el valor especificado.

Sobrecargas

Item[Int32]	Obtiene o establece el valor en el índice especificado.
Item[Object]	Obtiene o establece el valor con la clave especificada.

Item[Int32]

Source:

OrderedDictionary.cs

Obtiene o establece el valor en el índice especificado.

public:
 property System::Object ^ default[int] { System::Object ^ get(int index); void set(int index, System::Object ^ value); };

public object? this[int index] { get; set; }

member this.Item(int) : obj with get, set

Default Public Property Item(index As Integer) As Object

Parámetros

index

Int32

El índice de base cero del valor que se va a obtener o establecer.

Valor de propiedad

Object

Valor del elemento en el índice especificado.

Implementaciones

Item[Int32]

Excepciones

NotSupportedException

Se está estableciendo la propiedad y la colección OrderedDictionary es de sólo lectura.

ArgumentOutOfRangeException

index es menor que cero.

O bien

index es igual o mayor que Count.

Comentarios

Esta propiedad permite tener acceso a un elemento específico de la colección mediante la sintaxis siguiente: myCollection[index].

El lenguaje C# usa la palabra clave this para definir los indexadores en lugar de implementar la Item[] propiedad . Visual Basic implementa Item[] como una propiedad predeterminada, que proporciona la misma funcionalidad de indexación.

Item[Object]

Source:

OrderedDictionary.cs

Obtiene o establece el valor con la clave especificada.

public:
 property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };

public object? this[object key] { get; set; }

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

Default Public Property Item(key As Object) As Object

Parámetros

key

Object

Clave del valor que se va a obtener o establecer.

Valor de propiedad

Object

Valor asociado a la clave especificada. Si no se encuentra la clave especificada, al intentar obtenerla se devuelve null y al intentar establecerla se crea una nueva entrada con la clave especificada.

Implementaciones

Item[Object]

Excepciones

NotSupportedException

Se está estableciendo la propiedad y la colección OrderedDictionary es de sólo lectura.

Ejemplos

En el ejemplo de código siguiente se muestra la modificación de una OrderedDictionary colección. En este ejemplo, la Item[] propiedad se usa para modificar la entrada del diccionario con la clave "testKey2". Este código forma parte de un ejemplo de código más grande que se puede ver en OrderedDictionary.

// Modifying the OrderedDictionary
if (!myOrderedDictionary->IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary->Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary->RemoveAt(myOrderedDictionary->Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary->Contains("keyToDelete"))
    {
        myOrderedDictionary->Remove("keyToDelete");
    }
}

// Modifying the OrderedDictionary
if (!myOrderedDictionary.IsReadOnly)
{
    // Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1");

    // Modify the value of the entry with the key "testKey2"
    myOrderedDictionary["testKey2"] = "modifiedValue";

    // Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1);

    // Remove the "keyToDelete" entry, if it exists
    if (myOrderedDictionary.Contains("keyToDelete"))
    {
        myOrderedDictionary.Remove("keyToDelete");
    }
}

' Modifying the OrderedDictionary
If Not myOrderedDictionary.IsReadOnly Then

    ' Insert a new key to the beginning of the OrderedDictionary
    myOrderedDictionary.Insert(0, "insertedKey1", "insertedValue1")

    ' Modify the value of the entry with the key "testKey2"
    myOrderedDictionary("testKey2") = "modifiedValue"

    ' Remove the last entry from the OrderedDictionary: "testKey3"
    myOrderedDictionary.RemoveAt(myOrderedDictionary.Count - 1)

    ' Remove the "keyToDelete" entry, if it exists
    If (myOrderedDictionary.Contains("keyToDelete")) Then
        myOrderedDictionary.Remove("keyToDelete")
    End If
End If

Comentarios

Esta propiedad permite tener acceso a un elemento específico de la colección mediante la sintaxis siguiente: myCollection[key].

También puede usar la Item[] propiedad para agregar nuevos elementos estableciendo el valor de una clave que no existe en la OrderedDictionary colección (por ejemplo, myCollection["myNonexistentKey"] = myValue). Sin embargo, si la clave especificada ya existe en OrderedDictionary, al establecer la propiedad se Item[] sobrescribe el valor anterior. En cambio, el Add método no modifica los elementos existentes.

Una clave no puede ser null, pero un valor puede ser . Para distinguir entre null que se devuelve porque no se encuentra la clave especificada y null que se devuelve porque el valor de la clave especificada es null, use el Contains método para determinar si la clave existe en .OrderedDictionary