NameValueCollection.Item[] Propriedade

Definição

Namespace:

System.Collections.Specialized

Assembly:

System.Collections.Specialized.dll

Obtém ou define a entrada especificada do NameValueCollection.

Sobrecargas

Item[Int32]	Obtém a entrada no índice especificado do NameValueCollection.
Item[String]	Obtém ou define a entrada com a chave especificada no NameValueCollection.

Item[Int32]

Origem:

NameValueCollection.cs

Obtém a entrada no índice especificado do NameValueCollection.

public:
 property System::String ^ default[int] { System::String ^ get(int index); };

public string? this[int index] { get; }

member this.Item(int) : string

Default Public ReadOnly Property Item(index As Integer) As String

Parâmetros

index

Int32

O índice baseado em zero da entrada a ser localizado na coleção.

Valor da propriedade

String

Um String que contém a lista separada por vírgulas dos valores no índice especificado da coleção.

Exceções

ArgumentOutOfRangeException

index está fora do intervalo válido de índices para a coleção.

Comentários

Esta propriedade fornece a capacidade de acessar um elemento específico na coleção usando a seguinte sintaxe: myCollection[index].

Esta propriedade não pode ser definida. Para definir o valor em um índice especificado, use Item[GetKey(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.

Recuperar os valores no índice especificado é uma operação O(n), em n que é o número de valores.

Confira também

• Get
• Executando operações de cadeia de caracteres que não levam em conta a cultura

Item[String]

Origem:

NameValueCollection.cs

Obtém ou define a entrada com a chave especificada no NameValueCollection.

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

public string? this[string? name] { get; set; }

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

Default Public Property Item(name As String) As String

Parâmetros

name

String

A chave String da entrada a ser localizada. A chave pode ser null.

Valor da propriedade

String

Uma String que contém a lista de valores separados por vírgula associados à chave especificada, se encontrada; caso contrário, null.

Exceções

NotSupportedException

A coleção é somente leitura e a operação tenta modificar a coleção.

Comentários

Esta propriedade fornece a capacidade de acessar um elemento específico na coleção usando a seguinte sintaxe: myCollection[name].

Se a chave especificada já existir na coleção, definir essa propriedade substituirá a lista de valores existente pelo valor especificado. Para acrescentar o novo valor à lista de valores existente, use o Add método .

Se a chave especificada não existir na coleção, definir essa propriedade criará uma nova entrada usando a chave especificada e o valor especificado.

Cuidado

Essa propriedade retornará null nos seguintes casos: 1) se a chave especificada não for encontrada; e 2) se a chave especificada for encontrada e seu valor associado for null. Essa propriedade não distingue entre os dois casos.

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.

Recuperar ou definir os valores associados à chave especificada é uma operação O(n), em n que é o número de valores.

Confira também

• Get
• Executando operações de cadeia de caracteres que não levam em conta a cultura