SharePoint Foundation イベント ハンドラーのバインド
最終更新日: 2010年4月8日
適用対象: SharePoint Foundation 2010
イベント レシーバーは、SharePoint オブジェクトの種類 (イベント ホスト) に関連付ける必要があります。それには、イベント レシーバーをレシーバー ホストにバインドします。Microsoft SharePoint Foundation 2010 でイベント レシーバーをレシーバー ホストにバインドする方法は 2 つあります。
SharePoint Foundation オブジェクト モデルを使用する (「SharePoint オブジェクト モデルを使用してイベント ハンドラーをバインドする」を参照)。
SPWeb、SPList など、主な SharePoint オブジェクトの種類のほとんどが、オブジェクトをイベント ホストとして使用できるようにする EventReceivers プロパティを提供します。各イベント ホストのイベント レシーバーは SPEventReceiverDefinitionCollection コレクションに含まれており、このコレクションには、ホストに関連付けられているすべての個別のイベント定義 (SPEventReceiverDefinition) が含まれます。
Feature.xml ファイルを使用して、宣言によってイベントをイベント ホストにバインドすることもできます (「SharePoint Features.xml を使用してイベント ハンドラーをバインドする」を参照)。
Feature.xml アプローチを使用すると、広範なイベント バインドを作成し、そのイベント バインドをソリューション パッケージの一部として簡単に展開できます。たとえば、リスト テンプレート識別子 (ID) を使用して、お知らせリストすべてのイベント ハンドラーをバインドできます。これに含まれる機能が有効になっている場合は、指定した種類のすべてのリストに対してイベント ハンドラーをバインドできます。
また、コンテンツ タイプによって宣言的にイベントをバインドすることもできます。たとえば、指定した種類のすべてのドキュメントのイベント ハンドラーをバインドできます。イベント レシーバーをバインドするには、指定したコンテンツ タイプ定義の XML を使用します。
.gif "重要") 重要 |
|---|
SharePoint Foundation では、下位互換性を維持するためにライブラリ イベントがサポートされています。EventSinkAssembly、EventSinkClass、および EventSinkData の各プロパティは、以前のバージョンの SharePoint Foundation と同じように動作します。 |
注意
SharePoint Foundation 2010 で導入されたイベント モデルの強化機能については、「SharePoint Foundation 2010 のイベント モデルの改良」を参照してください。