IReliableDictionary<TKey,TValue>.GetOrAddAsync Método

Definición

Espacio de nombres:

Microsoft.ServiceFabric.Data.Collections

Ensamblado:

Microsoft.ServiceFabric.Data.Interfaces.dll

Paquete:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

Sobrecargas

GetOrAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)	Agrega un par clave-valor al diccionario de confianza si la clave aún no existe.
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>, TimeSpan, CancellationToken)	Agrega un par clave-valor al diccionario de confianza mediante la función especificada, si la clave aún no existe.
GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>)	Agrega un par clave-valor al diccionario de confianza mediante la función especificada, si la clave aún no existe.
GetOrAddAsync(ITransaction, TKey, TValue)	Agrega un par clave-valor al diccionario de confianza si la clave aún no existe. Si la clave no existe, no se realizará ninguna actualización en el valor.

GetOrAddAsync(ITransaction, TKey, TValue, TimeSpan, CancellationToken)

Agrega un par clave-valor al diccionario de confianza si la clave aún no existe.

public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Value>

Public Function GetOrAddAsync (tx As ITransaction, key As TKey, value As TValue, timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of TValue)

Parámetros

tx

ITransaction

Transacción con la que asociar esta operación.

key

TKey

Clave del elemento que se va a agregar.

value

TValue

Valor que se va a agregar si la clave aún no existe.

timeout

TimeSpan

Cantidad de tiempo que se debe esperar a que se complete la operación antes de iniciar timeoutException. Se usa principalmente para evitar interbloqueos. El valor predeterminado es 4 segundos.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es none.

Devoluciones

Task<TValue>

Tarea que representa la operación de adición asincrónica. El resultado de la tarea es el valor de la clave. Este será el valor existente para la clave si la clave ya está en el diccionario de confianza o el nuevo valor si la clave no estaba en el Diccionario confiable.

Excepciones

ArgumentNullException

tx es null o key es null o no se puede serializar.

ArgumentException

timeout es negativo.

TimeoutException

No se pudo completar la operación dentro del tiempo de espera especificado.

OperationCanceledException

Operación cancelada.

FabricNotPrimaryException

Excepción que se produce cuando IReliableDictionary<TKey,TValue> no está en Primary.

TransactionFaultedException

El sistema ha producido un error interno en la transacción. Reintentar la operación en una nueva transacción

InvalidOperationException

Se produce cuando una llamada de método no es válida para el estado actual del objeto. Por ejemplo, la transacción usada ya ha finalizado: el usuario lo confirma o anula. Si se produce esta excepción, es muy probable que haya un error en el código de servicio del uso de transacciones.

FabricObjectClosedException

Indica que el diccionario de confianza está cerrado o eliminado.

GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>, TimeSpan, CancellationToken)

Agrega un par clave-valor al diccionario de confianza mediante la función especificada, si la clave aún no existe.

public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Func<TKey,TValue> valueFactory, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Func<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Value>

Public Function GetOrAddAsync (tx As ITransaction, key As TKey, valueFactory As Func(Of TKey, TValue), timeout As TimeSpan, cancellationToken As CancellationToken) As Task(Of TValue)

Parámetros

tx

ITransaction

Transacción con la que asociar esta operación.

key

TKey

Clave del elemento que se va a agregar.

valueFactory

Func<TKey,TValue>

Función que se usa para generar un valor para la clave.

timeout

TimeSpan

Cantidad de tiempo que se debe esperar a que se complete la operación antes de iniciar timeoutException. Se usa principalmente para evitar interbloqueos. El valor predeterminado es 4 segundos.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es none.

Devoluciones

Task<TValue>

Tarea que representa la operación de adición asincrónica. El resultado de la tarea es el valor de la clave. Este será el valor existente para la clave si la clave ya está en el Diccionario de confianza o el nuevo valor de la clave tal y como devuelve valueFactory si la clave no estaba en el Diccionario confiable.

Excepciones

ArgumentNullException

tx es null, o key es null o no se puede serializar, o valueFactory es null.

ArgumentException

timeout es negativo.

TimeoutException

No se pudo completar la operación dentro del tiempo de espera especificado.

OperationCanceledException

Operación cancelada.

FabricNotPrimaryException

Excepción que se produce cuando IReliableDictionary<TKey,TValue> no está en Primary.

TransactionFaultedException

El sistema ha producido un error interno en la transacción. Reintentar la operación en una nueva transacción

InvalidOperationException

Se produce cuando una llamada de método no es válida para el estado actual del objeto. Por ejemplo, la transacción usada ya ha finalizado: el usuario lo confirma o anula. Si se produce esta excepción, es muy probable que haya un error en el código de servicio del uso de transacciones.

FabricObjectClosedException

Indica que el diccionario de confianza está cerrado o eliminado.

GetOrAddAsync(ITransaction, TKey, Func<TKey,TValue>)

Agrega un par clave-valor al diccionario de confianza mediante la función especificada, si la clave aún no existe.

public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, Func<TKey,TValue> valueFactory);

abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * Func<'Key, 'Value (requires 'Key :> IComparable<'Key> and 'Key :> IEquatable<'Key>)> -> System.Threading.Tasks.Task<'Value>

Public Function GetOrAddAsync (tx As ITransaction, key As TKey, valueFactory As Func(Of TKey, TValue)) As Task(Of TValue)

Parámetros

tx

ITransaction

Transacción con la que asociar esta operación.

key

TKey

Clave del elemento que se va a agregar.

valueFactory

Func<TKey,TValue>

Función que se usa para generar un valor para la clave.

Devoluciones

Task<TValue>

Tarea que representa la operación de adición asincrónica. El resultado de la tarea es el valor de la clave. Este será el valor existente para la clave si la clave ya está en el Diccionario de confianza o el nuevo valor de la clave tal y como devuelve valueFactory si la clave no estaba en el Diccionario confiable.

Excepciones

ArgumentNullException

tx es null, o key es null o no se puede serializar, o valueFactory es null.

TimeoutException

No se pudo completar la operación dentro del tiempo de espera predeterminado.

FabricNotPrimaryException

Excepción que se produce cuando IReliableDictionary<TKey,TValue> no está en Primary.

TransactionFaultedException

El sistema ha producido un error interno en la transacción. Reintentar la operación en una nueva transacción

InvalidOperationException

Se produce cuando una llamada de método no es válida para el estado actual del objeto. Por ejemplo, la transacción usada ya ha finalizado: el usuario lo confirma o anula. Si se produce esta excepción, es muy probable que haya un error en el código de servicio del uso de transacciones.

FabricObjectClosedException

Indica que el diccionario de confianza está cerrado o eliminado.

GetOrAddAsync(ITransaction, TKey, TValue)

Agrega un par clave-valor al diccionario de confianza si la clave aún no existe. Si la clave no existe, no se realizará ninguna actualización en el valor.

public System.Threading.Tasks.Task<TValue> GetOrAddAsync (Microsoft.ServiceFabric.Data.ITransaction tx, TKey key, TValue value);

abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * 'Key * 'Value -> System.Threading.Tasks.Task<'Value>

Public Function GetOrAddAsync (tx As ITransaction, key As TKey, value As TValue) As Task(Of TValue)

Parámetros

tx

ITransaction

Transacción con la que asociar esta operación.

key

TKey

Clave del elemento que se va a agregar.

value

TValue

Valor que se va a agregar si la clave aún no existe.

Devoluciones

Task<TValue>

Tarea que representa la operación de adición asincrónica. El resultado de la tarea es el valor de la clave. Este será el valor existente para la clave si la clave ya está en el diccionario de confianza o el nuevo valor si la clave no estaba en el Diccionario confiable.

Excepciones

ArgumentNullException

tx es null o key es null o no se puede serializar.

TimeoutException

No se pudo completar la operación dentro del tiempo de espera predeterminado.

FabricNotPrimaryException

Excepción que se produce cuando IReliableDictionary<TKey,TValue> no está en Primary.

TransactionFaultedException

El sistema ha producido un error interno en la transacción. Reintentar la operación en una nueva transacción

InvalidOperationException

Se produce cuando una llamada de método no es válida para el estado actual del objeto. Por ejemplo, la transacción usada ya ha finalizado: el usuario lo confirma o anula. Si se produce esta excepción, es muy probable que haya un error en el código de servicio del uso de transacciones.

FabricObjectClosedException

Indica que el diccionario de confianza está cerrado o eliminado.