BasicDesignerLoader.OnEndLoad(Boolean, ICollection) メソッド

定義

名前空間:

System.ComponentModel.Design.Serialization

アセンブリ:

System.Design.dll

読み込みが完了したことをデザイナー ローダーに通知します。

protected:
 virtual void OnEndLoad(bool successful, System::Collections::ICollection ^ errors);

protected virtual void OnEndLoad(bool successful, System.Collections.ICollection errors);

abstract member OnEndLoad : bool * System.Collections.ICollection -> unit
override this.OnEndLoad : bool * System.Collections.ICollection -> unit

Protected Overridable Sub OnEndLoad (successful As Boolean, errors As ICollection)

パラメーター

successful

Boolean

true 読み込みが正常に完了した場合。それ以外の場合は false。

errors

ICollection

エラーとして報告されたオブジェクト (通常は例外) を含む ICollection 。

例外

InvalidOperationException

IDesignerLoaderHostが初期化されていません。

ObjectDisposedException

IDesignerLoaderHostが破棄されました。

注釈

読み込みが完了すると、 OnEndLoad メソッドが呼び出されます。 読み込み中に例外がスローされた場合でも、常に呼び出されます。 successfulの値は、読み込みが成功した場合はtrueに設定され、致命的なエラーが発生した場合はfalseされます。 errors コレクションには、エラーとして報告されたオブジェクトが含まれます。 通常、これらのオブジェクトは例外です。

依存読み込みサポートを提供するIDesignerLoaderServiceを実装する場合は、IDesignerLoaderService.DependentLoadComplete メソッドの最後の呼び出しの後にOnEndLoad メソッドを呼び出す必要があります。 既定では、 BasicDesignerLoader は IDesignerLoaderService を実装し、これを行います。 BeginLoadが呼び出されたときにIDesignerLoaderServiceが使用できない場合、BeginLoadはPerformLoadを呼び出した後に直接OnEndLoadを呼び出します。

このメソッドは、依存するすべての読み込みが完了したときにデザイナー ローダー サービスによって呼び出される必要があります。 これにより、 BeginLoad メソッドによって開始された読み込みプロセスが停止します。 独自のローダー サービスを提供する場合、またはローダー サービスを提供しないことを選択した場合は、このメソッドを呼び出す必要があります。 BeginLoad メソッドは、IDesignerLoaderServiceが使用可能な場合はIDesignerLoaderService.DependentLoadComplete メソッドを間接的に呼び出すか、そうでない場合は直接呼び出すことによって、これを自動的に呼び出します。