DataObjectChangeEvents.EndEventGroup メソッド
StartEventGroup のメソッドを呼び出すことによって開始されたイベント グループを終了します。
名前空間: Microsoft.VisualStudio.Data
アセンブリ: Microsoft.VisualStudio.Data (Microsoft.VisualStudio.Data.dll 内)
構文
'宣言
Public MustOverride Sub EndEventGroup ( _
groupId As Integer _
)
public abstract void EndEventGroup(
int groupId
)
public:
virtual void EndEventGroup(
int groupId
) abstract
abstract EndEventGroup :
groupId:int -> unit
public abstract function EndEventGroup(
groupId : int
)
パラメーター
groupId
型 : Int32指定したイベントのグループの ID 番号。
例外
| 例外 | 条件 |
|---|---|
| ArgumentOutOfRangeException | groupId パラメーターは、以下で割り当てられているグループの現在の値より大きい。 |
| ArgumentException | groupId パラメーターが無効です。 |
解説
状況により、複数の変更イベントは、グループ化する必要があり、分割不可能なトランザクションとして扱われます。
通常、イベント リスナーは、イベント通知イベント グループにグループ内で発生させるイベントのキューのアセンブルによって対応します; また、後でのみイベント グループが終了した通知、トランザクション的な方法で処理されるイベントです。つまり、すべてのイベントが適用されていない場合、またはイベントによって適用されません)。
通知の横に、イベントのグループ化はイベント グループの階層、グループ ID で識別されるそれぞれの仕様を有効にすることによって実装されます。 通知者は StartEventGroupをグループの ID を返すことによって開始されます。 この通知 RaiseObjectAdded者は、RaiseObjectChangedとグループ ID を渡す RaiseObjectRemoved のメソッドを呼び出します。(必要に応じて、通知者は現在のグループ ID の StartEventGroup を再度呼び出して埋め込まれたなイベント グループを開始できます。
最後に通知者はグループ ID を使用して EndEventGroupを呼び出します。 一度最上位のグループ (ゼロのパラメーターと StartEventGroup を呼び出すことによって作成されたグループ) を一つのイベントのリスナーに、そのグループに発生させるすべてイベントをディスパッチする終了することがあります。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。