IReliableDictionary<TKey,TValue> Interface

Definição

Namespace:

Microsoft.ServiceFabric.Data.Collections

Assembly:

Microsoft.ServiceFabric.Data.Interfaces.dll

Pacote:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

Representa uma Coleção Confiável de pares chave/valor que são persistentes e replicados.

public interface IReliableDictionary<TKey,TValue> : Microsoft.ServiceFabric.Data.Collections.IReliableCollection<System.Collections.Generic.KeyValuePair<TKey,TValue>> where TKey : IComparable<TKey>, IEquatable<TKey>

type IReliableDictionary<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> = interface
    interface IReliableCollection<KeyValuePair<'Key, 'Value>>
    interface IReliableState

Public Interface IReliableDictionary(Of TKey, TValue)
Implements IReliableCollection(Of KeyValuePair(Of TKey, TValue))

Parâmetros de tipo

TKey

O tipo das chaves no Dicionário Confiável.

TValue

O tipo dos valores no Dicionário Confiável.

Derivado

Microsoft.ServiceFabric.Data.Collections.Beta.IReliableDictionary3<TKey,TValue>

Microsoft.ServiceFabric.Data.Collections.IReliableDictionary2<TKey,TValue>

Implementações

IReliableCollection<KeyValuePair<TKey,TValue>> IReliableState

Comentários

Chaves ou valores armazenados neste dicionário NÃO DEVEM ser modificados fora do contexto de uma operação no dicionário. É altamente recomendável tornar ambos TKey e TValue imutáveis para evitar a corrupção acidental de dados. Consulte aqui para obter armadilhas comuns.

A transação é a unidade de simultaneidade. Os usuários podem ter várias transações em voo a qualquer momento, mas para uma determinada transação, cada API deve ser chamada uma de cada vez. Ao chamar qualquer método de Coleção Confiável assíncrona que usa um ITransaction, você deve aguardar a conclusão da Tarefa retornada antes de chamar outro método usando a mesma transação. Veja exemplos de transações aqui.

Propriedades

Name	Obtém um valor que indica o nome exclusivo da IReliableState instância. (Herdado de IReliableState)
RebuildNotificationAsyncCallback	Uma função que é chamada quando o Dicionário Confiável está sendo recriado durante a cópia, restauração ou recuperação.

Métodos

AddAsync(ITransaction, TKey, TValue)	Adiciona o par chave/valor especificado ao Dicionário Confiável.
AddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	Adiciona o par chave/valor especificado ao Dicionário Confiável.
AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>)	Usa as funções especificadas para adicionar um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou atualizar um par chave/valor no Dicionário Confiável se a chave já existir.
AddOrUpdateAsync(ITransaction, TKey, Func<TKey,TValue>, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken)	Usa as funções especificadas para adicionar um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou atualizar um par chave/valor no Dicionário Confiável se a chave já existir.
AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>)	Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou atualizar um par chave/valor no Dicionário Confiável usando a função especificada se a chave já existir.
AddOrUpdateAsync(ITransaction, TKey, TValue, Func<TKey,TValue,TValue>, TimeSpan, CancellationToken)	Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou atualizar um par chave/valor no Dicionário Confiável usando a função especificada se a chave já existir.
ClearAsync()	Remove todo o estado do , incluindo o IReliableCollection<T>estado replicado e persistente. (Herdado de IReliableCollection<T>)
ClearAsync(TimeSpan, CancellationToken)	Remove todas as chaves e valores do Dicionário Confiável.
ContainsKeyAsync(ITransaction, TKey)	Determina se o Dicionário Confiável contém a chave especificada.
ContainsKeyAsync(ITransaction, TKey, LockMode)	Determina se o Dicionário Confiável contém a chave especificada.
ContainsKeyAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)	Determina se o Dicionário Confiável contém a chave especificada.
ContainsKeyAsync(ITransaction, TKey, TimeSpan, CancellationToken)	Determina se o Dicionário Confiável contém a chave especificada.
CreateEnumerableAsync(ITransaction)	Cria um enumerador assíncrono sobre o IReliableDictionary<TKey,TValue>.
CreateEnumerableAsync(ITransaction, EnumerationMode)	Cria um enumerador assíncrono sobre o IReliableDictionary<TKey,TValue>.
CreateEnumerableAsync(ITransaction, Func<TKey,Boolean>, EnumerationMode)	Cria um enumerador assíncrono sobre o IReliableDictionary<TKey,TValue>.
GetCountAsync(ITransaction)	Obtém o número de elementos contidos no IReliableCollection<T>. (Herdado de IReliableCollection<T>)
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>)	Adiciona um par chave/valor ao Dicionário Confiável usando a função especificada, se a chave ainda não existir.
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>, TimeSpan, CancellationToken)	Adiciona um par chave/valor ao Dicionário Confiável usando a função especificada, se a chave ainda não existir.
GetOrAddAsync(ITransaction, TKey, TValue)	Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir. Se a chave não existir, nenhuma atualização será feita no valor .
GetOrAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir.
SetAsync(ITransaction, TKey, TValue)	Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou atualizará um par chave/valor no Dicionário Confiável se a chave já existir.
SetAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	Adiciona um par chave/valor ao Dicionário Confiável se a chave ainda não existir ou atualizará um par chave/valor no Dicionário Confiável se a chave já existir.
TryAddAsync(ITransaction, TKey, TValue)	Tenta adicionar a chave e o valor especificados ao Dicionário Confiável.
TryAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	Tenta adicionar a chave e o valor especificados ao Dicionário Confiável.
TryGetValueAsync(ITransaction, TKey)	Tenta obter o valor associado à chave especificada do Dicionário Confiável.
TryGetValueAsync(ITransaction, TKey, LockMode)	Tenta obter o valor associado à chave especificada do Dicionário Confiável.
TryGetValueAsync(ITransaction, TKey, LockMode, TimeSpan, CancellationToken)	Tenta obter o valor associado à chave especificada do Dicionário Confiável.
TryGetValueAsync(ITransaction, TKey, TimeSpan, CancellationToken)	Tenta obter o valor associado à chave especificada do Dicionário Confiável.
TryRemoveAsync(ITransaction, TKey)	Tenta remover o valor com a chave especificada do Dicionário Confiável.
TryRemoveAsync(ITransaction, TKey, TimeSpan, CancellationToken)	Tenta remover o valor com a chave especificada do Dicionário Confiável.
TryUpdateAsync(ITransaction, TKey, TValue, TValue)	Compara o valor existente para a chave especificada com um valor especificado e se eles forem iguais, atualiza a chave com um terceiro valor.
TryUpdateAsync(ITransaction, TKey, TValue, TValue, TimeSpan, CancellationToken)	Compara o valor existente para a chave especificada com um valor especificado e se eles forem iguais, atualiza a chave com um terceiro valor.

Eventos

DictionaryChanged

Ocorre quando o Dicionário Confiável é alterado. Por exemplo, adição, atualização ou remoção de um item.