OrderedDictionary.Item[] Propriedade

Definição

Namespace:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Obtém ou define o valor especificado.

Sobrecargas

Item[Int32]	Obtém ou define o valor no índice especificado.
Item[Object]	Obtém ou define o valor com a chave especificada.

Item[Int32]

Origem:

OrderedDictionary.cs

Obtém ou define o valor no í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

O índice baseado em zero do valor a ser obtido ou definido.

Valor da propriedade

Object

O valor do item no índice especificado.

Implementações

Item[Int32]

Exceções

NotSupportedException

A propriedade está sendo definida e a coleção OrderedDictionary é somente leitura.

ArgumentOutOfRangeException

index é menor que zero.

- ou -

index é igual a ou maior que Count.

Comentários

Essa propriedade permite que você acesse um elemento específico na coleção usando a seguinte sintaxe: myCollection[index].

A linguagem C# usa esse palavra-chave para definir os indexadores em vez de implementar a Item[] propriedade . O Visual Basic implementa Item[] como uma propriedade padrão, que fornece a mesma funcionalidade de indexação.

Item[Object]

Origem:

OrderedDictionary.cs

Obtém ou define o valor com a chave 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

A chave do valor a ser obtido ou definido.

Valor da propriedade

Object

O valor associado à chave especificada. Se a chave especificada não for encontrada, tentar obtê-la retornará null e tentar de defini-la criará um novo elemento usando a chave especificada.

Implementações

Item[Object]

Exceções

NotSupportedException

A propriedade está sendo definida e a coleção OrderedDictionary é somente leitura.

Exemplos

O exemplo de código a seguir demonstra a modificação de uma coleção OrderedDictionary . Neste exemplo, a Item[] propriedade é usada para modificar a entrada do dicionário com a chave "testKey2". Esse código faz parte de um exemplo de código maior que pode ser exibido em 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

Comentários

Essa propriedade permite que você acesse um elemento específico na coleção usando a seguinte sintaxe: myCollection[key].

Você também pode usar a Item[] propriedade para adicionar novos elementos definindo o valor de uma chave que não existe na OrderedDictionary coleção (por exemplo, myCollection["myNonexistentKey"] = myValue). No entanto, se a chave especificada já existir no , definir OrderedDictionarya Item[] propriedade substituirá o valor antigo. Por outro lado, o Add método não modifica elementos existentes.

Uma chave não pode ser null, mas um valor pode ser. Para distinguir entre null o que é retornado porque a chave especificada não foi encontrada e null que é retornada porque o valor da chave especificada é null, use o Contains método para determinar se a chave existe no OrderedDictionary.