IReliableStateManager.GetOrAddAsync メソッド

定義

名前空間:

Microsoft.ServiceFabric.Data

アセンブリ:

Microsoft.ServiceFabric.Data.Interfaces.dll

パッケージ:

Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

オーバーロード

GetOrAddAsync<T>(String)	指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。
GetOrAddAsync<T>(Uri)	指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。
GetOrAddAsync<T>(ITransaction, String)	指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。
GetOrAddAsync<T>(ITransaction, Uri)	指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。
GetOrAddAsync<T>(String, TimeSpan)	指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。
GetOrAddAsync<T>(Uri, TimeSpan)	指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。
GetOrAddAsync<T>(ITransaction, String, TimeSpan)	指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。
GetOrAddAsync<T>(ITransaction, Uri, TimeSpan)	指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。

GetOrAddAsync<T>(String)

指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。

public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (string name) where T : Microsoft.ServiceFabric.Data.IReliableState;

abstract member GetOrAddAsync : string -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)

Public Function GetOrAddAsync(Of T As IReliableState) (name As String) As Task(Of T)

型パラメーター

T

型を IReliableState 指定するときに、クラス型またはインターフェイス型のいずれかを要求できます。

クラス型を指定すると、システムはその型のインスタンスを返そうとします。 その型のインスタンスをインスタンス化できない場合 (抽象クラス、適切なコンストラクターなしなど)、ArgumentException がスローされます。

インターフェイスの種類を指定すると、マネージャーはインターフェイスを具象型に解決しようとします。 型マッピングがユーザーによって指定されている場合、このメソッドはユーザー指定のマッピングを使用して型を解決します (まだサポートされていません)。 型マッピングがユーザーによって指定されていない場合、このメソッドは指定されたインターフェイスの既定の実装を選択します。 指定されたインターフェイス型に既定の実装がない場合、または型のユーザー指定のマッピングが指定されていない場合、または型が無効な場合、このメソッドは ArgumentException をスローします。

パラメーター

name

String

IReliableState の名前。 この名前は、関連のない型を含む型間IReliableStateでIReliableStateManager一意である必要があります。

戻り値

Task<T>

非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。

例外

ArgumentNullException

name が null です。

ArgumentException

型 T のインスタンスを作成できないか、既存 IReliableState のインスタンスが 型 Tではありません。

TimeoutException

既定のタイムアウト内で操作を完了できませんでした。

FabricNotPrimaryException

が にない場合 IReliableStateManager に Primaryスローされます。

FabricObjectClosedException

Reliable State Manager が閉じられたことを示します。

TransactionFaultedException

操作がシステムによって内部的に障害が発生しました。 操作をやり直してください

注釈

これはアトミック操作です。 を IReliableState 作成する必要がある場合は、完了して正常に返されるか、作成されません。

GetOrAddAsync<T>(Uri)

指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。

public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Uri name) where T : Microsoft.ServiceFabric.Data.IReliableState;

abstract member GetOrAddAsync : Uri -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)

Public Function GetOrAddAsync(Of T As IReliableState) (name As Uri) As Task(Of T)

型パラメーター

T

型を IReliableState 指定するときに、クラス型またはインターフェイス型のいずれかを要求できます。

クラス型を指定すると、システムはその型のインスタンスを返そうとします。 その型のインスタンスをインスタンス化できない場合 (抽象クラス、適切なコンストラクターなしなど)、ArgumentException がスローされます。

インターフェイスの種類を指定すると、マネージャーはインターフェイスを具象型に解決しようとします。 型マッピングがユーザーによって指定されている場合、このメソッドはユーザー指定のマッピングを使用して型を解決します (まだサポートされていません)。 型マッピングがユーザーによって指定されていない場合、このメソッドは指定されたインターフェイスの既定の実装を選択します。 指定されたインターフェイス型に既定の実装がない場合、または型のユーザー指定のマッピングが指定されていない場合、または型が無効な場合、このメソッドは ArgumentException をスローします。

パラメーター

name

Uri

IReliableState の名前。 この名前は、関連のない型を含む型間IReliableStateでIReliableStateManager一意である必要があります。

戻り値

Task<T>

非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。

例外

ArgumentNullException

name が null です。

ArgumentException

型 T のインスタンスを作成できないか、既存 IReliableState のインスタンスが 型 Tではありません。

TimeoutException

既定のタイムアウト内で操作を完了できませんでした。

FabricNotPrimaryException

が にない場合 IReliableStateManager に Primaryスローされます。

FabricObjectClosedException

Reliable State Manager が閉じられたことを示します。

TransactionFaultedException

操作がシステムによって内部的に障害が発生しました。 操作をやり直してください

注釈

これはアトミック操作です。 を IReliableState 作成する必要がある場合は、完了して正常に返されるか、作成されません。

GetOrAddAsync<T>(ITransaction, String)

指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。

public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Microsoft.ServiceFabric.Data.ITransaction tx, string name) where T : Microsoft.ServiceFabric.Data.IReliableState;

abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * string -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)

Public Function GetOrAddAsync(Of T As IReliableState) (tx As ITransaction, name As String) As Task(Of T)

型パラメーター

T

型を IReliableState 指定するときに、クラス型またはインターフェイス型のいずれかを要求できます。

クラス型を指定すると、システムはその型のインスタンスを返そうとします。 その型のインスタンスをインスタンス化できない場合 (抽象クラス、適切なコンストラクターなしなど)、ArgumentException がスローされます。

インターフェイスの種類を指定すると、マネージャーはインターフェイスを具象型に解決しようとします。 型マッピングがユーザーによって指定されている場合、このメソッドはユーザー指定のマッピングを使用して型を解決します (まだサポートされていません)。 型マッピングがユーザーによって指定されていない場合、このメソッドは指定されたインターフェイスの既定の実装を選択します。 指定されたインターフェイス型に既定の実装がない場合、または型のユーザー指定のマッピングが指定されていない場合、または型が無効な場合、このメソッドは ArgumentException をスローします。

パラメーター

tx

ITransaction

この操作を関連付けるトランザクション。

name

String

IReliableState の名前。 この名前は、関連のない型を含む型間IReliableStateでIReliableStateManager一意である必要があります。

戻り値

Task<T>

非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。

例外

ArgumentNullException

tx が null、または name null です。

ArgumentException

型 T のインスタンスを作成できないか、既存 IReliableState のインスタンスが 型 Tではありません。

TimeoutException

既定のタイムアウト内で操作を完了できませんでした。

FabricNotPrimaryException

が にない場合 IReliableStateManager に Primaryスローされます。

TransactionFaultedException

トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する

InvalidOperationException

オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。

FabricObjectClosedException

Reliable State Manager が閉じられたことを示します。

注釈

これはアトミック操作です。 を IReliableState 作成する必要がある場合は、完了して正常に返されるか、作成されません。 このメソッドが例外をスローする場合は、トランザクションを中止する必要があります。

GetOrAddAsync<T>(ITransaction, Uri)

指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。

public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Microsoft.ServiceFabric.Data.ITransaction tx, Uri name) where T : Microsoft.ServiceFabric.Data.IReliableState;

abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * Uri -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)

Public Function GetOrAddAsync(Of T As IReliableState) (tx As ITransaction, name As Uri) As Task(Of T)

型パラメーター

T

型を IReliableState 指定するときに、クラス型またはインターフェイス型のいずれかを要求できます。

クラス型を指定すると、システムはその型のインスタンスを返そうとします。 その型のインスタンスをインスタンス化できない場合 (抽象クラス、適切なコンストラクターなしなど)、ArgumentException がスローされます。

インターフェイスの種類を指定すると、マネージャーはインターフェイスを具象型に解決しようとします。 型マッピングがユーザーによって指定されている場合、このメソッドはユーザー指定のマッピングを使用して型を解決します (まだサポートされていません)。 型マッピングがユーザーによって指定されていない場合、このメソッドは指定されたインターフェイスの既定の実装を選択します。 指定されたインターフェイス型に既定の実装がない場合、または型のユーザー指定のマッピングが指定されていない場合、または型が無効な場合、このメソッドは ArgumentException をスローします。

パラメーター

tx

ITransaction

この操作を関連付けるトランザクション。

name

Uri

IReliableState の名前。 この名前は、関連のない型を含む型間IReliableStateでIReliableStateManager一意である必要があります。

戻り値

Task<T>

非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。

例外

ArgumentNullException

tx が null、または name null です。

ArgumentException

型 T のインスタンスを作成できないか、既存 IReliableState のインスタンスが 型 Tではありません。

TimeoutException

既定のタイムアウト内で操作を完了できませんでした。

FabricNotPrimaryException

が にない場合 IReliableStateManager に Primaryスローされます。

TransactionFaultedException

トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する

InvalidOperationException

オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。

FabricObjectClosedException

Reliable State Manager が閉じられたことを示します。

注釈

これはアトミック操作です。 を IReliableState 作成する必要がある場合は、完了して正常に返されるか、作成されません。 このメソッドが例外をスローする場合は、トランザクションを中止する必要があります。

GetOrAddAsync<T>(String, TimeSpan)

指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。

public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (string name, TimeSpan timeout) where T : Microsoft.ServiceFabric.Data.IReliableState;

abstract member GetOrAddAsync : string * TimeSpan -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)

Public Function GetOrAddAsync(Of T As IReliableState) (name As String, timeout As TimeSpan) As Task(Of T)

型パラメーター

T

型を IReliableState 指定するときに、クラス型またはインターフェイス型のいずれかを要求できます。

クラス型を指定すると、システムはその型のインスタンスを返そうとします。 その型のインスタンスをインスタンス化できない場合 (抽象クラス、適切なコンストラクターなしなど)、ArgumentException がスローされます。

インターフェイスの種類を指定すると、マネージャーはインターフェイスを具象型に解決しようとします。 型マッピングがユーザーによって指定されている場合、このメソッドはユーザー指定のマッピングを使用して型を解決します (まだサポートされていません)。 型マッピングがユーザーによって指定されていない場合、このメソッドは指定されたインターフェイスの既定の実装を選択します。 指定されたインターフェイス型に既定の実装がない場合、または型のユーザー指定のマッピングが指定されていない場合、または型が無効な場合、このメソッドは ArgumentException をスローします。

パラメーター

name

String

IReliableState の名前。 この名前は、関連のない型を含む型間IReliableStateでIReliableStateManager一意である必要があります。

timeout

TimeSpan

TimeoutException をスローするまでの操作の完了を待機する時間。 主にデッドロックを防ぐために使用されます。 既定値は 4 秒です。

戻り値

Task<T>

非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。

例外

ArgumentNullException

name が null です。

ArgumentException

型Tのインスタンスを作成できないか、既存IReliableStateのインスタンスが 型ではないかtimeout、負の値Tです。

TimeoutException

指定されたタイムアウト内に操作を完了できませんでした。

FabricNotPrimaryException

が にない場合 IReliableStateManager に Primaryスローされます。

FabricObjectClosedException

Reliable State Manager が閉じられたことを示します。

TransactionFaultedException

操作がシステムによって内部的に障害が発生しました。 操作をやり直してください

注釈

これはアトミック操作です。 を IReliableState 作成する必要がある場合は、完了して正常に返されるか、作成されません。

GetOrAddAsync<T>(Uri, TimeSpan)

指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。

public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Uri name, TimeSpan timeout) where T : Microsoft.ServiceFabric.Data.IReliableState;

abstract member GetOrAddAsync : Uri * TimeSpan -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)

Public Function GetOrAddAsync(Of T As IReliableState) (name As Uri, timeout As TimeSpan) As Task(Of T)

型パラメーター

T

型を IReliableState 指定するときに、クラス型またはインターフェイス型のいずれかを要求できます。

クラス型を指定すると、システムはその型のインスタンスを返そうとします。 その型のインスタンスをインスタンス化できない場合 (抽象クラス、適切なコンストラクターなしなど)、ArgumentException がスローされます。

インターフェイスの種類を指定すると、マネージャーはインターフェイスを具象型に解決しようとします。 型マッピングがユーザーによって指定されている場合、このメソッドはユーザー指定のマッピングを使用して型を解決します (まだサポートされていません)。 型マッピングがユーザーによって指定されていない場合、このメソッドは指定されたインターフェイスの既定の実装を選択します。 指定されたインターフェイス型に既定の実装がない場合、または型のユーザー指定のマッピングが指定されていない場合、または型が無効な場合、このメソッドは ArgumentException をスローします。

パラメーター

name

Uri

IReliableState の名前。 この名前は、関連のない型を含む型間IReliableStateでIReliableStateManager一意である必要があります。

timeout

TimeSpan

TimeoutException をスローするまでの操作の完了を待機する時間。 主にデッドロックを防ぐために使用されます。 既定値は 4 秒です。

戻り値

Task<T>

非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。

例外

ArgumentNullException

name が null です。

ArgumentException

型Tのインスタンスを作成できないか、既存IReliableStateのインスタンスが 型ではないかtimeout、負の値Tです。

TimeoutException

指定されたタイムアウト内に操作を完了できませんでした。

FabricNotPrimaryException

が にない場合 IReliableStateManager に Primaryスローされます。

FabricObjectClosedException

Reliable State Manager が閉じられたことを示します。

TransactionFaultedException

操作がシステムによって内部的に障害が発生しました。 操作をやり直してください

注釈

これはアトミック操作です。 を IReliableState 作成する必要がある場合は、完了して正常に返されるか、作成されません。

GetOrAddAsync<T>(ITransaction, String, TimeSpan)

指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。

public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Microsoft.ServiceFabric.Data.ITransaction tx, string name, TimeSpan timeout) where T : Microsoft.ServiceFabric.Data.IReliableState;

abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * string * TimeSpan -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)

Public Function GetOrAddAsync(Of T As IReliableState) (tx As ITransaction, name As String, timeout As TimeSpan) As Task(Of T)

型パラメーター

T

型を IReliableState 指定するときに、クラス型またはインターフェイス型のいずれかを要求できます。

クラス型を指定すると、システムはその型のインスタンスを返そうとします。 その型のインスタンスをインスタンス化できない場合 (抽象クラス、適切なコンストラクターなしなど)、ArgumentException がスローされます。

インターフェイスの種類を指定すると、マネージャーはインターフェイスを具象型に解決しようとします。 型マッピングがユーザーによって指定されている場合、このメソッドはユーザー指定のマッピングを使用して型を解決します (まだサポートされていません)。 型マッピングがユーザーによって指定されていない場合、このメソッドは指定されたインターフェイスの既定の実装を選択します。 指定されたインターフェイス型に既定の実装がない場合、または型のユーザー指定のマッピングが指定されていない場合、または型が無効な場合、このメソッドは ArgumentException をスローします。

パラメーター

tx

ITransaction

この操作を関連付けるトランザクション。

name

String

IReliableState の名前。 この名前は、関連のない型を含む型間IReliableStateでIReliableStateManager一意である必要があります。

timeout

TimeSpan

TimeoutException をスローするまでの操作の完了を待機する時間。 主にデッドロックを防ぐために使用されます。 既定値は 4 秒です。

戻り値

Task<T>

非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。

例外

ArgumentNullException

tx が null、または name null です。

ArgumentException

型Tのインスタンスを作成できないか、既存IReliableStateのインスタンスが 型ではないかtimeout、負の値Tです。

TimeoutException

指定されたタイムアウト内に操作を完了できませんでした。

FabricNotPrimaryException

が にない場合 IReliableStateManager に Primaryスローされます。

TransactionFaultedException

トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する

InvalidOperationException

オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。

FabricObjectClosedException

Reliable State Manager が閉じられたことを示します。

注釈

これはアトミック操作です。 を IReliableState 作成する必要がある場合は、完了して正常に返されるか、作成されません。 このメソッドが例外をスローする場合は、トランザクションを中止する必要があります。

GetOrAddAsync<T>(ITransaction, Uri, TimeSpan)

指定された型Tの をIReliableState取得し、指定した名前が存在する場合は を取得します。存在しない場合は、それを作成して返します。

public System.Threading.Tasks.Task<T> GetOrAddAsync<T> (Microsoft.ServiceFabric.Data.ITransaction tx, Uri name, TimeSpan timeout) where T : Microsoft.ServiceFabric.Data.IReliableState;

abstract member GetOrAddAsync : Microsoft.ServiceFabric.Data.ITransaction * Uri * TimeSpan -> System.Threading.Tasks.Task<'T (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)> (requires 'T :> Microsoft.ServiceFabric.Data.IReliableState)

Public Function GetOrAddAsync(Of T As IReliableState) (tx As ITransaction, name As Uri, timeout As TimeSpan) As Task(Of T)

型パラメーター

T

型を IReliableState 指定するときに、クラス型またはインターフェイス型のいずれかを要求できます。

クラス型を指定すると、システムはその型のインスタンスを返そうとします。 その型のインスタンスをインスタンス化できない場合 (抽象クラス、適切なコンストラクターなしなど)、ArgumentException がスローされます。

インターフェイスの種類を指定すると、マネージャーはインターフェイスを具象型に解決しようとします。 型マッピングがユーザーによって指定されている場合、このメソッドはユーザー指定のマッピングを使用して型を解決します (まだサポートされていません)。 型マッピングがユーザーによって指定されていない場合、このメソッドは指定されたインターフェイスの既定の実装を選択します。 指定されたインターフェイス型に既定の実装がない場合、または型のユーザー指定のマッピングが指定されていない場合、または型が無効な場合、このメソッドは ArgumentException をスローします。

パラメーター

tx

ITransaction

この操作を関連付けるトランザクション。

name

Uri

IReliableState の名前。 この名前は、関連のない型を含む型間IReliableStateでIReliableStateManager一意である必要があります。

timeout

TimeSpan

TimeoutException をスローするまでの操作の完了を待機する時間。 主にデッドロックを防ぐために使用されます。 既定値は 4 秒です。

戻り値

Task<T>

非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。

例外

ArgumentNullException

tx が null、または name null です。

ArgumentException

型Tのインスタンスを作成できないか、既存IReliableStateのインスタンスが 型ではないかtimeout、負の値Tです。

TimeoutException

指定されたタイムアウト内に操作を完了できませんでした。

FabricNotPrimaryException

が にない場合 IReliableStateManager に Primaryスローされます。

TransactionFaultedException

トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する

InvalidOperationException

オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。

FabricObjectClosedException

Reliable State Manager が閉じられたことを示します。

注釈

これはアトミック操作です。 を IReliableState 作成する必要がある場合は、完了して正常に返されるか、作成されません。 このメソッドが例外をスローする場合は、トランザクションを中止する必要があります。