IReadOnlyDictionary<TKey,TValue> Interfaz

Definición

Representa una colección genérica de solo lectura de pares clave-valor.Represents a generic read-only collection of key/value pairs.

generic <typename TKey, typename TValue>
public interface class IReadOnlyDictionary : System::Collections::Generic::IEnumerable<System::Collections::Generic::KeyValuePair<TKey, TValue>>, System::Collections::Generic::IReadOnlyCollection<System::Collections::Generic::KeyValuePair<TKey, TValue>>
public interface IReadOnlyDictionary<TKey,TValue> : System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<TKey,TValue>>, System.Collections.Generic.IReadOnlyCollection<System.Collections.Generic.KeyValuePair<TKey,TValue>>
type IReadOnlyDictionary<'Key, 'Value> = interface
    interface IReadOnlyCollection<KeyValuePair<'Key, 'Value>>
    interface seq<KeyValuePair<'Key, 'Value>>
    interface IEnumerable
Public Interface IReadOnlyDictionary(Of TKey, TValue)
Implements IEnumerable(Of KeyValuePair(Of TKey, TValue)), IReadOnlyCollection(Of KeyValuePair(Of TKey, TValue))

Parámetros de tipo

TKey

Tipo de las claves del diccionario de solo lectura.The type of keys in the read-only dictionary.

TValue

Tipo de los valores del diccionario de solo lectura.The type of values in the read-only dictionary.

Derivado
Implementaciones

Comentarios

Cada elemento es un par clave-valor que se almacena en un objeto KeyValuePair<TKey,TValue>.Each element is a key/value pair that is stored in a KeyValuePair<TKey,TValue> object.

Cada par debe tener una clave única.Each pair must have a unique key. Las implementaciones pueden variar en lo que se refiere a si permiten especificar una clave que se null.Implementations can vary in whether they allow you to specify a key that is null. El valor se puede null y no tiene que ser único.The value can be null and does not have to be unique. La interfaz IReadOnlyDictionary<TKey,TValue> permite enumerar las claves y los valores contenidos, pero no implica ningún criterio de ordenación concreto.The IReadOnlyDictionary<TKey,TValue> interface allows the contained keys and values to be enumerated, but it does not imply any particular sort order.

La instrucción foreach del C# lenguaje (For Each en Visual Basic, for each en C++) requiere el tipo de cada elemento de la colección.The foreach statement of the C# language (For Each in Visual Basic, for each in C++) requires the type of each element in the collection. Dado que cada elemento de la interfaz IReadOnlyDictionary<TKey,TValue> es un par clave-valor, el tipo de elemento no es el tipo de la clave o el tipo del valor.Because each element of the IReadOnlyDictionary<TKey,TValue> interface is a key/value pair, the element type is not the type of the key or the type of the value. En su lugar, el tipo de elemento es KeyValuePair<TKey,TValue>, como se muestra en el ejemplo siguiente.Instead, the element type is KeyValuePair<TKey,TValue>, as the following example illustrates.

for each(KeyValuePair<int, String^> kvp in myDictionary)
{
    Console::WriteLine("Key = {0}, Value = {1}", kvp.Key, kvp.Value);
}
foreach (KeyValuePair<int, string> kvp in myDictionary)
{
    Console.WriteLine("Key = {0}, Value = {1}", kvp.Key, kvp.Value);
}
For Each kvp As KeyValuePair(Of Integer, String) In myDictionary
    Console.WriteLine("Key = {0}, Value = {1}", kvp.Key, kvp.Value)
Next kvp

La instrucción foreach es un contenedor alrededor del enumerador; solo permite la lectura de la colección, no la escritura en la colección.The foreach statement is a wrapper around the enumerator; it allows only reading from the collection, not writing to the collection.

Propiedades

Count

Obtiene el número de elementos de la colección.Gets the number of elements in the collection.

(Heredado de IReadOnlyCollection<T>)
Item[TKey]

Obtiene el elemento que tiene la clave especificada en el diccionario de solo lectura.Gets the element that has the specified key in the read-only dictionary.

Keys

Obtiene una colección enumerable que contiene las claves del diccionario de solo lectura.Gets an enumerable collection that contains the keys in the read-only dictionary.

Values

Obtiene una colección enumerable que contiene los valores del diccionario de solo lectura.Gets an enumerable collection that contains the values in the read-only dictionary.

Métodos

ContainsKey(TKey)

Determina si el diccionario de solo lectura contiene un elemento con la clave especificada.Determines whether the read-only dictionary contains an element that has the specified key.

GetEnumerator()

Devuelve un enumerador que itera una colección.Returns an enumerator that iterates through a collection.

(Heredado de IEnumerable)
TryGetValue(TKey, TValue)

Obtiene el valor que está asociado a la clave especificada.Gets the value that is associated with the specified key.

Métodos de extensión

GetValueOrDefault<TKey,TValue>(IReadOnlyDictionary<TKey,TValue>, TKey)

Intenta obtener el valor asociado al elemento key especificado en dictionary.Tries to get the value associated with the specified key in the dictionary.

GetValueOrDefault<TKey,TValue>(IReadOnlyDictionary<TKey,TValue>, TKey, TValue)

Intenta obtener el valor asociado a la clave especificada en dictionary.Tries to get the value associated with the specified key in the dictionary.

CopyToDataTable<T>(IEnumerable<T>)

Devuelve un objeto DataTable que contiene copias de los objetos DataRow, dado un objeto IEnumerable<T> de entrada donde el parámetro T genérico es DataRow.Returns a DataTable that contains copies of the DataRow objects, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption)

Copia objetos DataRow en el objeto DataTable especificado, dado un objeto IEnumerable<T> de entrada donde el parámetro T genérico es DataRow.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

CopyToDataTable<T>(IEnumerable<T>, DataTable, LoadOption, FillErrorEventHandler)

Copia objetos DataRow en el objeto DataTable especificado, dado un objeto IEnumerable<T> de entrada donde el parámetro T genérico es DataRow.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Devuelve una colección de elementos que contiene los antecesores de todos los nodos de la colección de origen.Returns a collection of elements that contains the ancestors of every node in the source collection.

Ancestors<T>(IEnumerable<T>, XName)

Devuelve una colección de elementos filtrada que contiene los antecesores de todos los nodos de la colección de origen.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Devuelve una colección de los nodos descendientes de todos los documentos y elementos de la colección de origen.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Devuelve una colección de elementos que contiene los elementos descendientes de todos los elementos y documentos de la colección de origen.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

Descendants<T>(IEnumerable<T>, XName)

Devuelve una colección filtrada de elementos que contiene los elementos descendientes de todos los elementos y documentos de la colección de origen.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Devuelve una colección de los elementos secundarios de todos los elementos y documentos de la colección de origen.Returns a collection of the child elements of every element and document in the source collection.

Elements<T>(IEnumerable<T>, XName)

Devuelve una colección filtrada de los elementos secundarios de todos los elementos y documentos de la colección de origen.Returns a filtered collection of the child elements of every element and document in the source collection. En la colección sólo se incluyen los elementos que tienen un objeto XName coincidente.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Devuelve una colección de nodos que contiene todos los nodos de la colección de origen, clasificados por documento.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Devuelve una colección de los nodos secundarios de todos los documentos y elementos de la colección de origen.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Quita todos los nodos de la colección de origen de su nodo primario.Removes every node in the source collection from its parent node.

Se aplica a