NameValueCollection.Item[] Propiedad

Definición

Obtiene o establece la entrada especificada de NameValueCollection.Gets or sets the specified entry of the NameValueCollection.

Sobrecargas

Item[Int32]

Obtiene la entrada que se encuentra en el índice especificado de NameValueCollection.Gets the entry at the specified index of the NameValueCollection.

Item[String]

Obtiene o establece la entrada con la clave especificada en NameValueCollection.Gets or sets the entry with the specified key in the NameValueCollection.

Item[Int32]

Obtiene la entrada que se encuentra en el índice especificado de NameValueCollection.Gets the entry at the specified index of the 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

Índice de base cero de la entrada que se va a localizar en la colección.The zero-based index of the entry to locate in the collection.

Valor de propiedad

String

String que contiene la lista de valores separados por comas en el índice especificado de la colección.A String that contains the comma-separated list of values at the specified index of the collection.

Excepciones

index está fuera del intervalo válido de índices de la colección.index is outside the valid range of indexes for the collection.

Comentarios

Esta propiedad permite acceder a un elemento determinado de la colección mediante la sintaxis siguiente: myCollection[index].This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[index].

No se puede establecer esta propiedad.This property cannot be set. Para establecer el valor en un índice especificado, use Item[GetKey(index)] .To set the value at a specified index, use Item[GetKey(index)].

El lenguaje C# utiliza la palabra clave this para definir los indizadores en lugar de implementar la Item[] propiedad.The C# language uses the this keyword to define the indexers instead of implementing the Item[] property. Visual Basic implementa Item[] como una propiedad predeterminada, que proporciona la misma funcionalidad de indización.Visual Basic implements Item[] as a default property, which provides the same indexing functionality.

La recuperación de los valores en el índice especificado es una operación O ( n ), donde n es el número de valores.Retrieving the values at the specified index is an O(n) operation, where n is the number of values.

Consulte también

Se aplica a

Item[String]

Obtiene o establece la entrada con la clave especificada en NameValueCollection.Gets or sets the entry with the specified key in the 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

Clave String de la entrada que se va a localizar.The String key of the entry to locate. La clave puede ser null.The key can be null.

Valor de propiedad

String

String que contiene la lista de valores, separados por comas, asociados a la clave especificada, si se encuentra; en caso contrario, es null.A String that contains the comma-separated list of values associated with the specified key, if found; otherwise, null.

Excepciones

La colección es de sólo lectura y la operación ha intentado modificarla.The collection is read-only and the operation attempts to modify the collection.

Comentarios

Esta propiedad permite acceder a un elemento determinado de la colección mediante la sintaxis siguiente: myCollection[name].This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[name].

Si la clave especificada ya existe en la colección, al establecer esta propiedad se sobrescribe la lista de valores existente con el valor especificado.If the specified key already exists in the collection, setting this property overwrites the existing list of values with the specified value. Para anexar el nuevo valor a la lista de valores existente, use el Add método.To append the new value to the existing list of values, use the Add method.

Si la clave especificada no existe en la colección, al establecer esta propiedad se crea una nueva entrada con la clave y el valor especificados.If the specified key does not exist in the collection, setting this property creates a new entry using the specified key and the specified value.

Precaución

Esta propiedad devuelve null en los casos siguientes: 1) si no se encuentra la clave especificada; y 2) si se encuentra la clave especificada y su valor asociado es null .This property returns null in the following cases: 1) if the specified key is not found; and 2) if the specified key is found and its associated value is null. Esta propiedad no distingue entre los dos casos.This property does not distinguish between the two cases.

El lenguaje C# utiliza la palabra clave this para definir los indizadores en lugar de implementar la Item[] propiedad.The C# language uses the this keyword to define the indexers instead of implementing the Item[] property. Visual Basic implementa Item[] como una propiedad predeterminada, que proporciona la misma funcionalidad de indización.Visual Basic implements Item[] as a default property, which provides the same indexing functionality.

Recuperar o establecer los valores asociados a la clave especificada es una operación O ( n ), donde n es el número de valores.Retrieving or setting the values associated with the specified key is an O(n) operation, where n is the number of values.

Consulte también

Se aplica a