NameValueCollection.Item[] Propriedade

Definição

Namespace:
System.Collections.Specialized
Assemblies:
System.dll, System.Collections.Specialized.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Obtém ou define a entrada especificada do NameValueCollection.

Sobrecargas

Nome 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 baseado em zero da entrada a ser localizada na coleção.

Valor da propriedade

String

Um String que contém a lista separada por vírgulas de 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

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

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

A linguagem C# usa essa 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 está o número de valores.

Confira 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 a ser localizada. A chave pode ser null.

Valor da propriedade

String

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

Exceções

NotSupportedException

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

Comentários

Essa 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 com o 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, a definição dessa propriedade criará uma nova entrada usando a chave especificada e o valor especificado.

Caution

Essa propriedade retorna 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 essa 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 está o número de valores.

Confira também

Aplica-se a