AsynchronousExportError イベント

非同期エクスポート操作で例外が発生された場合に発生します。

シンタックス

Visual Basic

'宣言
 
Public Event AsynchronousExportError As AsynchronousExportErrorEventHandler

C#

public event AsynchronousExportErrorEventHandler AsynchronousExportError

イベント データ

イベント ハンドラが、このイベントに関連するデータを含む、AsynchronousExportErrorEventArgs 型の引数を受け取りました。次の AsynchronousExportErrorEventArgs プロパティには、このイベントの固有の情報が記載されます。

プロパティ	解説
DisplayErrorMessage	エラー ダイアログが UltraGridExcelExporter によって表示されるかどうかを取得または設定します。
Exception	非同期エクスポート プロセス中に発生した例外、またはエラーが例外によって発生したのではない場合は null。
FileName	AsynchExport メソッドで指定のファイル名。
Workbook	エクスポート中のワークブック。

解説

このイベントは、エラーまたは例外が非同期エクスポート操作中に発生した時に発生します。たとえば、ファイルにエクスポートしようとして、ファイルがロックされており上書きできなかったような場合です。

デフォルトでは、UltraGridExcelExporter はエラー メッセージを表示し、エクスポート プロセスはキャンセルされます。自身のメッセージを表示し、またはワークブックを異なるファイル名で再度保存を試みるため、DisplayErrorMessage を false に設定することで、デフォルトのエラー メッセージをキャンセルします。

このイベントは非同期エクスポート操作でのみ発生することに注意してください。同期操作に対しては、例外は呼び出しをエクスポート メソッドに折り返すことで発生し、ブロックをキャッチします。