MenuDesigner.GetErrorDesignTimeHtml メソッド

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

MenuDesigner.GetErrorDesignTimeHtml メソッド

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

エラーが発生した場合に、関連付けられたコントロールをデザイン時表示するためのマークアップを提供します。

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

Visual Basic (宣言)

Protected Overrides Function
 GetErrorDesignTimeHtml ( _
    e As Exception _
) As String

Visual Basic (使用法)

Dim e As Exception
Dim returnValue As String

returnValue = Me.GetErrorDesignTimeHtml(e)

C#

protected override string GetErrorDesignTimeHtml
 (
    Exception e
)

C++

protected:
virtual String^ GetErrorDesignTimeHtml (
    Exception^ e
) override

J#

protected String GetErrorDesignTimeHtml (
    Exception e
)

JScript

protected override function GetErrorDesignTimeHtml
 (
    e : Exception
) : String

パラメータ

e

スローされた Exception オブジェクト。

戻り値
エラーが発生した後で、関連付けられた Menu のデザイン時表示に使用するマークアップを含んだ文字列。

解説

GetErrorDesignTimeHtml メソッドは、デザイン時の Menu コントロールに、型名、コントロール名、およびエラーを説明するメッセージを含んだプレースホルダとしてエラーを表示するマークアップを生成します。

使用例

MenuDesigner クラスから継承したクラスの GetErrorDesignTimeHtml メソッドをオーバーライドする方法を次のコード例に示します。オーバーライドされたメソッドは、デザイン時に Menu クラスから派生したコントロールの外観を変更します。この例では、赤の太字で表示されるエラー メッセージを含んだプレースホルダのマークアップを生成しています。

Visual Basic

' Generate the design-time markup for the control when an error occurs.
Protected Overrides Function
 GetErrorDesignTimeHtml( _
    ByVal ex As Exception) As
 String

    ' Write the error message text in red, bold.
    Dim errorRendering As String
 = _
        "<span style=""font-weight:bold;
 color:Red; "">" & _
        ex.Message & "</span>"

    Return CreatePlaceHolderDesignTimeHtml(errorRendering)

End Function ' GetErrorDesignTimeHtml

C#

// Generate the design-time markup for the control when an error occurs.
protected override string GetErrorDesignTimeHtml(Exception
 ex) 
{
    // Write the error message text in red, bold.
    string errorRendering =
        "<span style=\"font-weight:bold; color:Red; \">"
 +
        ex.Message + "</span>";

    return CreatePlaceHolderDesignTimeHtml(errorRendering);
} // GetErrorDesignTimeHtml

.NET Framework のセキュリティ

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

プラットフォーム

Windows 98, Windows 2000 SP4, 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

参照

関連項目
MenuDesigner クラス
MenuDesigner メンバ
System.Web.UI.Design.WebControls 名前空間
GetDesignTimeHtml
GetEmptyDesignTimeHtml
Menu
その他の技術情報
チュートリアル : Web サーバー コントロール用の基本的なコントロール デザイナの作成