ControlDesigner.UpdateDesignTimeHtml 方法

定義

命名空間:

System.Web.UI.Design

組件:

System.Design.dll

藉由呼叫 GetDesignTimeHtml 方法，為關聯的 Web 伺服器控制項重新整理設計階段 HTML 標記。

public:
 virtual void UpdateDesignTimeHtml();

public virtual void UpdateDesignTimeHtml ();

abstract member UpdateDesignTimeHtml : unit -> unit
override this.UpdateDesignTimeHtml : unit -> unit

Public Overridable Sub UpdateDesignTimeHtml ()

範例

下列程式代碼範例示範如何回應 Click 控件設計工具中的事件，以變更多區域控件中區域之間的焦點，並使用 UpdateDesignTimeHtml 方法來更新設計主控制件的外觀。

此程式代碼範例是 類別較大範例的 EditableDesignerRegion 一部分。

// 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();
    }
}

' 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

備註

設計 UpdateDesignTimeHtml 主機會呼叫 方法，以在設計時間更新相關聯 Web 伺服器控件的顯示，例如修改控件的時間。 此外，控件設計工具可以在修改控件的值之後呼叫 UpdateDesignTimeHtml 方法，以更新控件的顯示。

注意

如果您要呼叫 ComponentChanged 事件，或使用 PropertyDescriptor 對象來設定屬性，介面會 IComponentChangeService 為您呼叫 UpdateDesignTimeHtml 方法。

另請參閱

• ComponentChanged
• ASP.NET 控件設計工具概觀