BasicDesignerLoader.OnEndLoad メソッド

.NET Framework クラス ライブラリ リファレンス

BasicDesignerLoader.OnEndLoad メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.ComponentModel.Design.Serialization
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim successful As Boolean
Dim errors As ICollection

Me.OnEndLoad(successful, errors)

C#

protected virtual void OnEndLoad (
    bool successful,
    ICollection errors
)

C++

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

J#

protected void OnEndLoad (
    boolean successful, 
    ICollection errors
)

JScript

protected function OnEndLoad (
    successful : boolean, 
    errors : ICollection
)

パラメータ

successful

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

errors

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

例外

例外の種類	条件
InvalidOperationException	IDesignerLoaderHost が初期化されていません。
ObjectDisposedException	IDesignerLoaderHost は破棄されています。

解説

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

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

このメソッドは、すべての依存読み込みが完了したときに、デザイナ ローダー サービスによって呼び出される必要があります。このメソッドは、BeginLoad メソッドによって開始された読み込みプロセスを中断します。独自のローダー サービスを用意している場合、またはローダー サービスを用意しない場合は、自分でこのメソッドを呼び出す必要があります。BeginLoad メソッドは、このメソッドを自動的に呼び出します。IDesignerLoaderService を利用できる場合は、System.ComponentModel.Design.Serialization.IDesignerLoaderService.DependentLoadComplete メソッドを呼び出すことによって間接的に呼び出し、利用できない場合は直接呼び出します。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
BasicDesignerLoader クラス
BasicDesignerLoader メンバ
System.ComponentModel.Design.Serialization 名前空間