NameValueCollection.Item[] Propriedade

Definição

Espaço de Nomes:
System.Collections.Specialized
Assemblagens:
System.dll, System.Collections.Specialized.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Obtém ou define a entrada especificada do NameValueCollection.

Sobrecargas

Name Description
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]

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 base zero da entrada a localizar na coleção.

Valor de Propriedade

String

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

Exceções

ArgumentOutOfRangeException

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

Observações

Esta propriedade permite aceder a um elemento específico da coleção utilizando a seguinte sintaxe: myCollection[index].

Esta propriedade não pode ser definida. Para definir o valor num índice especificado, use Item[GetKey(index)].

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

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

Ver também

Aplica-se a

Item[String]

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 String chave da entrada para localizar. A chave pode ser null.

Valor de Propriedade

String

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

Exceções

NotSupportedException

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

Observações

Esta propriedade permite aceder a um elemento específico da coleção utilizando a seguinte sintaxe: myCollection[name].

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

Se a chave especificada não existir na coleção, definir esta propriedade cria uma nova entrada usando a chave e o valor especificados.

Atenção

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

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

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

Ver também

Aplica-se a