ControlDesigner.UpdateDesignTimeHtml メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ControlDesigner.UpdateDesignTimeHtml メソッド

GetDesignTimeHtml メソッドを呼び出して、関連付けられている Web サーバーコントロールのデザイン時 HTML マークアップを更新します。

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

Visual Basic (宣言)

Public Overridable Sub UpdateDesignTimeHtml

Visual Basic (使用法)

Dim instance As ControlDesigner

instance.UpdateDesignTimeHtml

public virtual void UpdateDesignTimeHtml ()

C++

public:
virtual void UpdateDesignTimeHtml ()

public void UpdateDesignTimeHtml ()

JScript

public function UpdateDesignTimeHtml ()

解説

UpdateDesignTimeHtml メソッドは、コントロールが変更された場合など、関連付けられている Web サーバーコントロールの表示をデザイン時に更新するためにデザインホストによって呼び出されます。また、コントロールデザイナによって、コントロールの値の変更後に UpdateDesignTimeHtml メソッドを呼び出して、コントロールの表示を更新することもできます。

メモ
ComponentChanged イベントを呼び出す場合、または PropertyDescriptor オブジェクトを使用してプロパティを設定する場合は、IComponentChangeService インターフェイスによって UpdateDesignTimeHtml メソッドが呼び出されます。

使用例

コントロールデザイナの Click イベントに応答して複数領域コントロール内の領域間でフォーカスを切り替え、UpdateDesignTimeHtml メソッドを使用してデザインホストのコントロールの外観を更新する方法のコード例を次に示します。

このコード例は、EditableDesignerRegion クラスのトピックで取り上げているコード例の一部です。

Visual Basic

' Handler for the Click event, which provides the region in the arguments.
Protected Overrides Sub
 OnClick(ByVal e As DesignerRegionMouseEventArgs)
    If IsNothing(e.Region) Then
        Return
    End If

    ' If the clicked region is not a header, return
    If e.Region.Name.IndexOf("Header")
 <> 0 Then
        Return
    End If

    ' Switch the current view if required
    If e.Region.Name.Substring(6, 1) <> myControl.CurrentView.ToString()
 Then
        myControl.CurrentView = Integer.Parse(e.Region.Name.Substring(6,
 1))
        MyBase.UpdateDesignTimeHtml()
    End If
End Sub

// Handler for the Click event, which provides the region in the arguments.
protected override void OnClick(DesignerRegionMouseEventArgs
 e)
{
    if (e.Region == null)
        return;

    // If the clicked region is not a header, return
    if (e.Region.Name.IndexOf("Header") != 0)
        return;

    // Switch the current view if required
    if (e.Region.Name.Substring(6, 1) != myControl.CurrentView.ToString())
    {
        myControl.CurrentView = int.Parse(e.Region.Name.Substring(6,
 1));
        base.UpdateDesignTimeHtml();
    }
}