SqlCeClientSyncProvider.ApplyChangeFailed イベント

クライアントで行を適用できなかった場合に発生します。

名前空間: Microsoft.Synchronization.Data.SqlServerCe
アセンブリ: Microsoft.Synchronization.Data.SqlServerCe (microsoft.synchronization.data.sqlserverce.dll 内)

構文

'宣言
Public Event ApplyChangeFailed As EventHandler(Of ApplyChangeFailedEventArgs)
'使用
Dim instance As SqlCeClientSyncProvider
Dim handler As EventHandler(Of ApplyChangeFailedEventArgs)

AddHandler instance.ApplyChangeFailed, handler
public event EventHandler<ApplyChangeFailedEventArgs> ApplyChangeFailed
public:
event EventHandler<ApplyChangeFailedEventArgs^>^ ApplyChangeFailed {
    void add (EventHandler<ApplyChangeFailedEventArgs^>^ value);
    void remove (EventHandler<ApplyChangeFailedEventArgs^>^ value);
}
/** @event */
public void add_ApplyChangeFailed (EventHandler<ApplyChangeFailedEventArgs> value)

/** @event */
public void remove_ApplyChangeFailed (EventHandler<ApplyChangeFailedEventArgs> value)
JScript supports the use of events, but not the declaration of new ones.

解説

同期中に行を適用できない場合は、ApplyChangeFailed イベントが発生します。ApplyChangeFailedEventArgs オブジェクトを使用すると、失敗の原因となったエラーまたは競合に関する情報が提供されます。イベントのハンドラーで、同期プロバイダーが行の適用を再試行するかどうかの指定など、いくつかの方法でイベントに応答できます。詳細については、「イベントを操作する方法とビジネス ロジックをプログラムする方法」および「データの競合とエラーを処理する方法」を参照してください。

次のコード例では、ApplyChangeFailed イベントのイベント ハンドラーを指定します。呼び出されたメソッドは、クライアント同期プロバイダーとサーバー同期プロバイダーの情報をそれぞれ異なるログ ファイルに記録します。完全なコンテキスト例でこのコードを表示するには、「セッション変数を使用する方法」を参照してください。

this.ApplyChangeFailed += new EventHandler<ApplyChangeFailedEventArgs>(EventLogger.LogEvents);
else if (e is ApplyChangeFailedEventArgs)
{

    ApplyChangeFailedEventArgs args = (ApplyChangeFailedEventArgs)e;
    outputText.AppendLine("** APPLY CHANGE FAILURE AT " + site.ToUpper() + " **");
    outputText.AppendLine("Table for which failure occurred: " + args.TableMetadata.TableName);
    outputText.AppendLine("Error message: " + args.Error.Message);

}
AddHandler Me.ApplyChangeFailed, AddressOf EventLogger.LogEvents
ElseIf TypeOf e Is ApplyChangeFailedEventArgs Then

    Dim args As ApplyChangeFailedEventArgs = CType(e, ApplyChangeFailedEventArgs)
    outputText.AppendLine("** APPLY CHANGE FAILURE AT " & site.ToUpper() & " **")
    outputText.AppendLine("Table for which failure occurred: " & args.TableMetadata.TableName)
    outputText.AppendLine("Error message: " & args.Error.Message)

参照

リファレンス

SqlCeClientSyncProvider クラス
SqlCeClientSyncProvider メンバー
Microsoft.Synchronization.Data.SqlServerCe 名前空間