IReliableStateManager.GetOrAddAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| GetOrAddAsync<T>(String) |
指定された型 |
| GetOrAddAsync<T>(Uri) |
指定された型 |
| GetOrAddAsync<T>(ITransaction, String) |
指定された型 |
| GetOrAddAsync<T>(ITransaction, Uri) |
指定された型 |
| GetOrAddAsync<T>(String, TimeSpan) |
指定された型 |
| GetOrAddAsync<T>(Uri, TimeSpan) |
指定された型 |
| GetOrAddAsync<T>(ITransaction, String, TimeSpan) |
指定された型 |
| GetOrAddAsync<T>(ITransaction, Uri, TimeSpan) |
指定された型 |
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一意である必要があります。
戻り値
非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。
例外
name が null です。
型 T のインスタンスを作成できないか、既存 IReliableState のインスタンスが 型 Tではありません。
既定のタイムアウト内で操作を完了できませんでした。
が にない場合 IReliableStateManager に Primaryスローされます。
Reliable State Manager が閉じられたことを示します。
操作がシステムによって内部的に障害が発生しました。 操作をやり直してください
注釈
これはアトミック操作です。 を 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一意である必要があります。
戻り値
非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。
例外
name が null です。
型 T のインスタンスを作成できないか、既存 IReliableState のインスタンスが 型 Tではありません。
既定のタイムアウト内で操作を完了できませんでした。
が にない場合 IReliableStateManager に Primaryスローされます。
Reliable State Manager が閉じられたことを示します。
操作がシステムによって内部的に障害が発生しました。 操作をやり直してください
注釈
これはアトミック操作です。 を 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一意である必要があります。
戻り値
非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。
例外
tx が null、または name null です。
型 T のインスタンスを作成できないか、既存 IReliableState のインスタンスが 型 Tではありません。
既定のタイムアウト内で操作を完了できませんでした。
が にない場合 IReliableStateManager に Primaryスローされます。
トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する
オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。
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一意である必要があります。
戻り値
非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。
例外
tx が null、または name null です。
型 T のインスタンスを作成できないか、既存 IReliableState のインスタンスが 型 Tではありません。
既定のタイムアウト内で操作を完了できませんでした。
が にない場合 IReliableStateManager に Primaryスローされます。
トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する
オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。
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 秒です。
戻り値
非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。
例外
name が null です。
型Tのインスタンスを作成できないか、既存IReliableStateのインスタンスが 型ではないかtimeout、負の値Tです。
指定されたタイムアウト内に操作を完了できませんでした。
が にない場合 IReliableStateManager に Primaryスローされます。
Reliable State Manager が閉じられたことを示します。
操作がシステムによって内部的に障害が発生しました。 操作をやり直してください
注釈
これはアトミック操作です。 を 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 秒です。
戻り値
非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。
例外
name が null です。
型Tのインスタンスを作成できないか、既存IReliableStateのインスタンスが 型ではないかtimeout、負の値Tです。
指定されたタイムアウト内に操作を完了できませんでした。
が にない場合 IReliableStateManager に Primaryスローされます。
Reliable State Manager が閉じられたことを示します。
操作がシステムによって内部的に障害が発生しました。 操作をやり直してください
注釈
これはアトミック操作です。 を 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 秒です。
戻り値
非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。
例外
tx が null、または name null です。
型Tのインスタンスを作成できないか、既存IReliableStateのインスタンスが 型ではないかtimeout、負の値Tです。
指定されたタイムアウト内に操作を完了できませんでした。
が にない場合 IReliableStateManager に Primaryスローされます。
トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する
オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。
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 秒です。
戻り値
非同期操作を表すタスク。 タスクの結果は、信頼できる状態インスタンスです。
例外
tx が null、または name null です。
型Tのインスタンスを作成できないか、既存IReliableStateのインスタンスが 型ではないかtimeout、負の値Tです。
指定されたタイムアウト内に操作を完了できませんでした。
が にない場合 IReliableStateManager に Primaryスローされます。
トランザクションがシステムによって内部的に障害が発生しました。 新しいトランザクションで操作を再試行する
オブジェクトの現在の状態に対してメソッド呼び出しが無効な場合にスローされます。 たとえば、使用されているトランザクションは既に終了しています。ユーザーによってコミットまたは中止されています。 この例外がスローされた場合、トランザクションを使用するサービス コードにバグがある可能性が高くなります。
Reliable State Manager が閉じられたことを示します。
注釈
これはアトミック操作です。 を IReliableState 作成する必要がある場合は、完了して正常に返されるか、作成されません。 このメソッドが例外をスローする場合は、トランザクションを中止する必要があります。
適用対象
Azure SDK for .NET
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示