次の方法で共有


プラグインでの例外の処理

 

公開日: 2016年11月

対象: Dynamics CRM 2015

同期プラグインでは、サンドボックスに登録されていてもいなくても、Microsoft Dynamics 365 プラットフォームは、プラットフォームに返された例外を、Web アプリケーション ユーザー インターフェイスのダイアログ内にエラー メッセージを表示することで処理します。 非同期に登録されたプラグインの例外メッセージは、Web アプリケーションのシステム ジョブ領域で表示できる、システム ジョブ (AsyncOperation) レコードに記録されます。

同期プラグインでは、オプションの操作として Web アプリケーションのエラー ダイアログ内にユーザー定義のエラー メッセージを表示することができます。これを行うには、プラグインで、例外メッセージ プロパティ値として、ユーザー定義メッセージ文字列と共に InvalidPluginExecutionException 例外をスローします。InvalidPluginExecutionException をスローし、ユーザー定義のメッセージを用意しない場合、一般的な既定のメッセージがエラー ダイアログに表示されます。 プラグインでは、InvalidPluginExecutionException だけをプラットフォームに戻すことをお勧めします。

同期プラグインがプラットフォームに InvalidPluginExecutionException 以外の例外を返す場合、エラー ダイアログが表示され、スタック トレース付きの例外メッセージ (System.Exception.Message) も 2 つのいずれかの場所に記録されます。 サンドボックスに登録されていないプラグインの場合、プラグインを実行するサーバー上のアプリケーション イベント ログに情報が記録されます。 イベント ログは、イベント ビューア管理ツールを使用して表示できます。 サンドボックスに登録されたプラグインでは、例外メッセージおよびスタック トレースは Microsoft Dynamics 365 プラットフォームのトレースに記録されます。 トレースの詳細は、プラグインのデバッグ のトピックのログおよびトレース セクションを参照してください。

関連項目

プラグインの開発
プラグイン間のデータの移動
プラグインを記述する
プラグインのデバッグ
コードで例外を処理する

© 2017 Microsoft. All rights reserved. 著作権