WebPartManager.CreateErrorWebPart メソッド

protected:
 virtual System::Web::UI::WebControls::WebParts::ErrorWebPart ^ CreateErrorWebPart(System::String ^ originalID, System::String ^ originalTypeName, System::String ^ originalPath, System::String ^ genericWebPartID, System::String ^ errorMessage);

protected virtual System.Web.UI.WebControls.WebParts.ErrorWebPart CreateErrorWebPart (string originalID, string originalTypeName, string originalPath, string genericWebPartID, string errorMessage);

abstract member CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart
override this.CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart

Protected Overridable Function CreateErrorWebPart (originalID As String, originalTypeName As String, originalPath As String, genericWebPartID As String, errorMessage As String) As ErrorWebPart

パラメーター

戻り値

読み込みまたは作成に失敗したコントロールの代わりにページに挿入する ErrorWebPart。

注釈

このメソッドは CreateErrorWebPart 、Web パーツ コントロール セットが動的 WebPart コントロールまたはサーバー コントロールのインスタンスの読み込みまたは作成を試みたときに呼び出され、何らかの理由で失敗します。 メソッドは オブジェクトを ErrorWebPart 作成し、エラー メッセージを割り当てて返します。 ErrorWebPart失敗したコントロールの代わりにコントロールが挿入され、そのエラー メッセージがページに表示されます。

コードからメソッドを CreateErrorWebPart 直接呼び出すことはできません。 ただし、 クラスから継承し、 WebPartManager メソッドを拡張することはできます。 詳細については、「継承者のメモ」セクションを参照してください。

エンド ユーザーは、通常WebPartのErrorWebPartコントロールと同じように、ページ内のコントロールを操作できます。 エラー メッセージを削除するには、閉じる動詞をクリックしてコントロールを閉じ、その時点で他の閉じたコントロールと同様に、コントロールがオブジェクトに PageCatalogPart 追加されます。 エンド ユーザーがコントロールを ErrorWebPart 削除すると、読み込みに失敗したサーバー コントロールもページから削除されます。

注意 (継承者)

コントロールで ErrorWebPart 返される情報をカスタマイズする場合は、メソッドをオーバーライド CreateErrorWebPart(String, String, String, String, String) し、基本メソッドを呼び出し、基本メソッドに渡されるパラメーターに異なる値を割り当ててから、結果 ErrorWebPart のコントロールを返すことができます。 たとえば、エンド ユーザーに値を表示 originalPath させたくない場合 (ユーザー コントロールの仮想ディレクトリ パスが表示されます)、基本メソッドを呼び出すときに、そのパラメーターに空の文字列 ("") を渡すことができます。

コントロール自体の動作は ErrorWebPart 、そのコントロールから継承してカスタマイズすることもできます。 たとえば、その Title プロパティまたは AllowMinimize プロパティをオーバーライドできます。

適用対象

こちらもご覧ください

• ErrorWebPart
• ASP.NET Web パーツ コントロール