DataServiceContext.BeginSaveChanges メソッド (SaveChangesOptions, AsyncCallback, Object)
変更が最後に保存された後に DataServiceContext によって収集された保留中の変更をデータ サービスに非同期的に送信します。
名前空間: System.Data.Services.Client
アセンブリ: Microsoft.Data.Services.Client (Microsoft.Data.Services.Client.dll)
構文
'宣言
Public Function BeginSaveChanges ( _
options As SaveChangesOptions, _
callback As AsyncCallback, _
state As Object _
) As IAsyncResult
'使用
Dim instance As DataServiceContext
Dim options As SaveChangesOptions
Dim callback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
returnValue = instance.BeginSaveChanges(options, _
callback, state)
public IAsyncResult BeginSaveChanges(
SaveChangesOptions options,
AsyncCallback callback,
Object state
)
public:
IAsyncResult^ BeginSaveChanges(
SaveChangesOptions options,
AsyncCallback^ callback,
Object^ state
)
member BeginSaveChanges :
options:SaveChangesOptions *
callback:AsyncCallback *
state:Object -> IAsyncResult
public function BeginSaveChanges(
options : SaveChangesOptions,
callback : AsyncCallback,
state : Object
) : IAsyncResult
パラメーター
- options
型: System.Data.Services.Client.SaveChangesOptions
クライアントが保留中の変更のセットを保存する方法のオプション。
- callback
型: System.AsyncCallback
操作が完了したときに呼び出すデリゲート。
- state
型: System.Object
コンテキスト データをコールバック メソッドに渡すために使用される、ユーザー定義の状態オブジェクト。
戻り値
型: System.IAsyncResult
非同期操作の状態を表す IAsyncResult。
説明
変更は、AddObject、AddLink、AttachTo、AttachLink、DeleteObject、DeleteLink、Detach、または DetachLink を呼び出すことで DataServiceContext に追加されます。
Batch が設定されている場合は、保留中のすべての変更がバッチ内の 1 つの変更セットに含まれ、1 つの HTTP 要求でデータ サービスに送信されます。 この場合は、ターゲット サービスがバッチ処理をサポートしている必要があります。
Batch が設定されていない場合:
変更は、SaveChanges() メソッドと同様、HTTP 要求あたり 1 回の操作でデータ サービスに送信されます。
StatusCode は常に 200 です。
Headers プロパティは空のコレクションを返します。
ContinueOnError が設定されている場合:
変更セットの操作の処理でエラーが発生した場合、変更セット内の後続の操作は試行されません。ただし、データ サービスにより、バッチ内の次の変更セットは引き続き処理されます。
このオプションは、Batch が設定されている場合には設定できません。バッチ処理が有効になっている場合は、すべての操作が 1 つの変更セットに配置されるためです。
ContinueOnError が設定されていない場合:
- 操作の処理中にエラーが発生した場合は、追加の操作はデータ サービスによって処理されません。
実行された操作、その結果、およびエラーが発生したために試行されなかった操作をクライアントに通知する応答が生成されます。