トレーニング
モジュール
Dynamics 365 Business Central でイベントを使用して機能を拡張する - Training
Microsoft Dynamics 365 Business Central で既存の機能にビジネス ロジックを追加する方法について知りたいですか? このモジュールでは、コードの使用およびイベントの処理方法について説明します。
このブラウザーはサポートされなくなりました。
Microsoft Edge にアップグレードすると、最新の機能、セキュリティ更新プログラム、およびテクニカル サポートを利用できます。
デリゲートのようなイベントは遅延バインディング メカニズムになっています。 実際、イベントはデリゲートの言語サポートに基づいて構築されます。
イベントは、何かが起こったことをオブジェクトが (システム内のあらゆる関連コンポーネントに) ブロードキャストする方法です。 他のコンポーネントはイベントを受信登録できます。イベントが発生すると通知されます。
プログラミングにイベントを利用した経験があることでしょう。 グラフィカル システムの多くには、ユーザー操作を報告するイベント モデルがあります。 そのようなイベントは、マウスが動いた、ボタンが押されたなどの動作を報告します。 それは最も一般的なイベントの 1 つですが、イベントが利用されるシナリオはこれだけではありません。
クラスに対して発生させるイベントを定義できます。 イベントを使用するときに考慮するべき重要なことは、特定のイベントに登録されていないオブジェクトの可能性です。 リスナーが構成されていないときはイベントを発生させないようにコードを記述する必要があります。
イベントを受信登録すると、2 つのオブジェクト (イベント ソースとイベント シンク) の間に結合も生成されます。 イベント シンクにイベントに対する関心がなくなったとき、イベント ソースの受信登録を解除する必要があります。
イベントの言語デザインには次のような目標があります。
イベント ソースとイベント シンクの間で最小限の結合を有効にすること。 これら 2 つのコンポーネントは、別々の組織に記述されることがあります。まったく異なる日程で更新されることもあります。
イベントの受信登録と、同じイベントの登録解除を非常にシンプルにすること。
イベント ソースで複数のイベント サブスクライバーに対応すること。 イベント サブスクライバーをアタッチしないことにも対応する必要があります。
イベントの目標はデリゲートの目標とよく似ています。 そのような理由から、イベント言語サポートはデリゲート言語サポートに基づいて構築されます。
イベントの定義、受信登録、登録解除の構文は、デリゲートの構文の拡張になります。
イベントを定義するには、event
キーワードを使用します。
public event EventHandler<FileListArgs> Progress;
イベントの種類 (この例の EventHandler<FileListArgs>
) はデリゲート型にする必要があります。 イベントを宣言するときはさまざまな決まりごとを守る必要があります。 通常、イベント デリゲート型には戻り値 void があります。
イベント宣言は動詞または動詞句にする必要があります。
何かが起こったことをイベントで報告するときは、過去時制を使用します。 何かが起こりそうなことを報告するには、現在時制の動詞 (たとえば、Closing
) を使用します。 多くの場合、現在時制の使用は、お使いのクラスで何らかのカスタマイズ動作をサポートしていることを示します。 最も一般的なシナリオの 1 つがキャンセルのサポートです。 たとえば、Closing
イベントには、close 操作を続行するかどうかを示す引数が含まれることがあります。 イベント引数のプロパティを更新することで呼び出し元が動作を変更するシナリオもあります。 アルゴリズムに実行させる次のアクションを提案するイベントを発生させることもできます。 イベント ハンドラーは、イベント引数のプロパティを変更することで、別のアクションを命令することもあります。
イベントが発生させるとき、デリゲート呼び出し構文を利用してイベント ハンドラーを呼び出します。
Progress?.Invoke(this, new FileListArgs(file));
デリゲートに関するセクションで説明したように、 ?. 演算子を利用すると、イベントのサブスクライバーが存在しないとき、そのイベントの発生を試行しないように容易に確保できます。
+=
演算子を利用し、イベントを受信登録します。
EventHandler<FileListArgs> onProgress = (sender, eventArgs) =>
Console.WriteLine(eventArgs.FoundFile);
fileLister.Progress += onProgress;
上に示すように、一般的にハンドラー メソッドはプレフィックス 'On' の後にイベント名を続けたものになります。
-=
演算子を利用して受信登録を解除します。
fileLister.Progress -= onProgress;
イベント ハンドラーを表す式にローカル変数が宣言することが重要です。 これで受信登録解除によりハンドラーが削除されます。 代わりにラムダ式の本文を使用した場合、アタッチされたことがないハンドラーの削除が試行され、何も起こりません。
次回の記事では、一般的なイベント パターンと今回のサンプルのさまざまなバリエーションについて学習します。
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。
トレーニング
モジュール
Dynamics 365 Business Central でイベントを使用して機能を拡張する - Training
Microsoft Dynamics 365 Business Central で既存の機能にビジネス ロジックを追加する方法について知りたいですか? このモジュールでは、コードの使用およびイベントの処理方法について説明します。
ドキュメント
System.Delegate と ’delegate’ キーワード - C#
デリゲートをサポートする .NET のクラスと、それが ’delegate’ キーワードにどのように対応付けられるかについて取り上げます。
コンポーネント間の密接な結合を避けるための、コードでのデリゲートの一般的な使用パターンについて説明します。
C# のデリゲートとイベントに関するシリーズ記事の 1 本目です。 この記事では、デリゲートの基本的な概念と、言語上の設計目標について説明します。