IActorStateManager.TryAddStateAsync<T> Method

Reference

Definition

Namespace:: Microsoft.ServiceFabric.Actors.Runtime

Assembly:: Microsoft.ServiceFabric.Actors.dll

Package:: Microsoft.ServiceFabric.Actors v6.1.1583

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Attempts to add an actor state with given state name and value. Returns false if an actor state with the same name already exists.

public System.Threading.Tasks.Task<bool> TryAddStateAsync<T> (string stateName, T value, System.Threading.CancellationToken cancellationToken = default);

abstract member TryAddStateAsync : string * 'T * System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Function TryAddStateAsync(Of T) (stateName As String, value As T, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Boolean)

Type Parameters

T

Type of value associated with given state name.

Parameters

stateName: String

Name of the actor state to add.

value: T

Value of the actor state to add.

cancellationToken: CancellationToken

The token to monitor for cancellation requests. This is optional and defaults to None

Returns

Task<Boolean>

A boolean task that represents the asynchronous add operation. Returns true if the value was successfully added and false if an actor state with the same name already exists.

Exceptions

ArgumentNullException

The specified state name is null. Provide a valid state name string.

OperationCanceledException

The request was canceled using the specified cancellationToken.

Remarks

The type of state value T must be Data Contract serializable.

Applies to

Dela via