ControlDesigner.UpdateDesignTimeHtml-Methode

Artikel
08/20/2007

Aktualisiert das Entwurfszeit-HTML-Markup für das zugeordnete Webserversteuerelement durch Aufruf der GetDesignTimeHtml-Methode.

Namespace: System.Web.UI.Design
Assembly: System.Design (in system.design.dll)

Syntax

'Declaration
Public Overridable Sub UpdateDesignTimeHtml
'Usage
Dim instance As ControlDesigner

instance.UpdateDesignTimeHtml

public virtual void UpdateDesignTimeHtml ()

public:
virtual void UpdateDesignTimeHtml ()

public void UpdateDesignTimeHtml ()

public function UpdateDesignTimeHtml ()

Hinweise

Die UpdateDesignTimeHtml-Methode wird vom Entwurfszeithost aufgerufen, um zur Entwurfszeit die Anzeige des zugeordneten Webserversteuerelements zu aktualisieren, z. B. nachdem Änderungen am Steuerelement vorgenommen wurden. Ein Designer kann die UpdateDesignTimeHtml-Methode auch aufrufen, nachdem Werte des Steuerelements geändert wurden, um die Anzeige des Steuerelements zu aktualisieren.

Hinweis

Wenn Sie das ComponentChanged-Ereignis aufrufen oder mithilfe des PropertyDescriptor-Objekts Eigenschaften festlegen, ruft die IComponentChangeService-Schnittstelle automatisch die UpdateDesignTimeHtml-Methode auf.

Beispiel

Im folgenden Codebeispiel wird gezeigt, wie auf ein Click-Ereignis in einem Steuerelementdesigner reagiert werden kann, um den Fokus zwischen Bereichen in einem Steuerelement mit mehreren Bereichen zu wechseln. Im Codebeispiel wird die Darstellung des Steuerelements im Entwurfshost mit der UpdateDesignTimeHtml-Methode aktualisiert.

Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels für die EditableDesignerRegion-Klasse.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter .

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ControlDesigner-Klasse
ControlDesigner-Member
System.Web.UI.Design-Namespace
ComponentChanged

Weitere Ressourcen

Entwurfszeitunterstützung für Web Forms

Freigeben über