IReadOnlyDictionary<TKey,TValue> Interface

Definição

{1&gt;Representa uma coleção somente leitura genérica de pares chave/valor.&lt;1}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

O tipo de chaves no dicionário somente leitura.The type of keys in the read-only dictionary.

TValue

O tipo de valores no dicionário somente leitura.The type of values in the read-only dictionary.

Derivado
Implementações

Comentários

Cada elemento é um par de chave/valor que é armazenado em um objeto KeyValuePair<TKey,TValue>.Each element is a key/value pair that is stored in a KeyValuePair<TKey,TValue> object.

Cada par deve ter uma chave exclusiva.Each pair must have a unique key. As implementações podem variar se permitirem que você especifique uma chave null.Implementations can vary in whether they allow you to specify a key that is null. O valor pode ser null e não precisa ser exclusivo.The value can be null and does not have to be unique. A interface IReadOnlyDictionary<TKey,TValue> permite que as chaves contidas e os valores sejam enumerados, mas não implica nenhuma ordem de classificação específica.The IReadOnlyDictionary<TKey,TValue> interface allows the contained keys and values to be enumerated, but it does not imply any particular sort order.

A instrução foreach do C# idioma (For Each em Visual Basic, for each em C++) requer o tipo de cada elemento na coleção.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. Como cada elemento da interface IReadOnlyDictionary<TKey,TValue> é um par chave/valor, o tipo de elemento não é o tipo da chave ou o tipo do 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. Em vez disso, o tipo de elemento é KeyValuePair<TKey,TValue>, como ilustra o exemplo a seguir.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

A instrução foreach é um wrapper em volta do enumerador; Ele permite somente a leitura da coleção, não a gravação na coleção.The foreach statement is a wrapper around the enumerator; it allows only reading from the collection, not writing to the collection.

Propriedades

Count

Obtém o número de elementos na coleção.Gets the number of elements in the collection.

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

Obtém o elemento que tem a chave especificada no dicionário somente leitura.Gets the element that has the specified key in the read-only dictionary.

Keys

Obtém uma coleção enumerável que contém as chaves no dicionário somente leitura.Gets an enumerable collection that contains the keys in the read-only dictionary.

Values

Obtém uma coleção enumerável que contém os valores no dicionário somente leitura.Gets an enumerable collection that contains the values in the read-only dictionary.

Métodos

ContainsKey(TKey)

Determina se o dicionário somente leitura contém um elemento que tem a chave especificada.Determines whether the read-only dictionary contains an element that has the specified key.

GetEnumerator()

Retorna um enumerador que itera em uma coleção.Returns an enumerator that iterates through a collection.

(Herdado de IEnumerable)
TryGetValue(TKey, TValue)

Obtém o valor associado à chave especificada.Gets the value that is associated with the specified key.

Métodos de Extensão

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

Tenta obter o valor associado ao key especificado no dictionary.Tries to get the value associated with the specified key in the dictionary.

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

Tenta obter o valor associado à chave especificada no dictionary.Tries to get the value associated with the specified key in the dictionary.

CopyToDataTable<T>(IEnumerable<T>)

Retorna um DataTable que contém cópias dos objetos DataRow, dado um objeto IEnumerable<T> de entrada em que o parâmetro genérico T é 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 no DataTable especificado, dado um objeto IEnumerable<T> de entrada em que o parâmetro genérico T é 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 no DataTable especificado, dado um objeto IEnumerable<T> de entrada em que o parâmetro genérico T é DataRow.Copies DataRow objects to the specified DataTable, given an input IEnumerable<T> object where the generic parameter T is DataRow.

Cast<TResult>(IEnumerable)

Converte os elementos de um IEnumerable para o tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra os elementos de um IEnumerable com base em um tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita a paralelização de uma consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte um IEnumerable em um IQueryable.Converts an IEnumerable to an IQueryable.

Ancestors<T>(IEnumerable<T>)

Retorna uma coleção de elementos que contém os ancestrais de cada nó na coleção de origem.Returns a collection of elements that contains the ancestors of every node in the source collection.

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

Retorna uma coleção filtrada de elementos que contém os ancestrais de cada nó na coleção de origem.Returns a filtered collection of elements that contains the ancestors of every node in the source collection. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

DescendantNodes<T>(IEnumerable<T>)

Retorna uma coleção dos nós descendentes de todos os documentos e elementos na coleção de origem.Returns a collection of the descendant nodes of every document and element in the source collection.

Descendants<T>(IEnumerable<T>)

Retorna uma coleção de elementos que contém os elementos descendentes de cada elemento e o documento na coleção de origem.Returns a collection of elements that contains the descendant elements of every element and document in the source collection.

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

Retorna uma coleção filtrada de elementos que contém os elementos descendentes de cada elemento e o documento na coleção de origem.Returns a filtered collection of elements that contains the descendant elements of every element and document in the source collection. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

Elements<T>(IEnumerable<T>)

Retorna uma coleção dos filhos elementos de cada elemento e o documento na coleção de origem.Returns a collection of the child elements of every element and document in the source collection.

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

Retorna uma coleção filtrada dos elementos filho de cada elemento e documento na coleção de origem.Returns a filtered collection of the child elements of every element and document in the source collection. Somente os elementos que têm um XName correspondente são incluídos na coleção.Only elements that have a matching XName are included in the collection.

InDocumentOrder<T>(IEnumerable<T>)

Retorna uma coleção de nós que contém todos os nós na coleção de origem, classificados em ordem segundo o documento.Returns a collection of nodes that contains all nodes in the source collection, sorted in document order.

Nodes<T>(IEnumerable<T>)

Retorna uma coleção dos nós filhos de todos os documentos e elementos na coleção de origem.Returns a collection of the child nodes of every document and element in the source collection.

Remove<T>(IEnumerable<T>)

Remove todos os nós na coleção de origem do respectivo nó pai.Removes every node in the source collection from its parent node.

Aplica-se a