NameValueCollection.Item[] Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.