Compartilhar via


NameValueCollection.Item[] Propriedade

Definição

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
Origem:
NameValueCollection.cs
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; }
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

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

Exceções

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

Aplica-se a

Item[String]

Origem:
NameValueCollection.cs
Origem:
NameValueCollection.cs
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; }
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

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

Exceções

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

Aplica-se a