ButtonDesigner.GetDesignTimeHtml Methode

Referenz

Definition

Namespace:: System.Web.UI.Design.WebControls

Assembly:: System.Design.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft das Markup ab, das zum Rendern des zugeordneten Steuerelements zur Entwurfszeit verwendet wird.

public:
 override System::String ^ GetDesignTimeHtml();

public override string GetDesignTimeHtml();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

Gibt zurück

String

Ein String, der das Markup enthält, mit dem der Button zur Entwurfszeit gerendert wird.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die GetDesignTimeHtml -Methode überschrieben wird, um das generierte Markup zu ändern.

Wenn die BorderStyle Eigenschaft zuvor noch nicht festgelegt wurde (d. h. sie verfügt über den NotSet Feldwert), wird sie durch einen Aufruf der GetDesignTimeHtml -Methode auf einen blau gestrichelten Rahmen mit einer Breite von drei Pixeln festgelegt, und dieser Rahmen wird dann auf der Entwurfsoberfläche angezeigt. Wenn die BorderStyle -Eigenschaft festgelegt wurde, werden die vorhandenen Border-Eigenschaftswerte angezeigt.

In der Regel ruft die GetDesignTimeHtml seine Basismethode auf, ControlDesigner.GetDesignTimeHtmldie die Control.RenderControl -Methode des zugeordneten Steuerelements aufruft, um das Markup zu generieren.

' Create a class that derives from ButtonDesigner
' and displays the custom SampleButton control
' on the design surface.
Imports System.Web.UI.Design
Imports System.Drawing
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls

Namespace Examples.AspNet 

    
    Public Class SampleButtonDesigner
        Inherits ButtonDesigner

        ' Override the GetDesignTimeHtml method.
        Public Overrides Function GetDesignTimeHtml() As String

            Dim sampleButton As SampleButton = CType(Component, SampleButton)
            Dim designTimeHtml As String = Nothing

            ' Check the control's BorderStyle property
            ' to conditionally render design-time HTML.
            If (sampleButton.BorderStyle = BorderStyle.NotSet) Then

                ' Create variables to hold current property settings.
                Dim oldBorderStyle As BorderStyle = sampleButton.BorderStyle
                Dim oldBorderWidth As Unit = sampleButton.BorderWidth
                Dim oldBorderColor As Color = sampleButton.BorderColor

                ' Set properties and the design-time HTML.
                Try
                    sampleButton.BorderStyle = BorderStyle.Dashed
                    sampleButton.BorderWidth = Unit.Pixel(3)
                    sampleButton.BorderColor = Color.Blue
                    designTimeHtml = MyBase.GetDesignTimeHtml()

                    ' If an exception occurs, call the GetErrorDesignTimeHtml
                    ' method.
                Catch ex As Exception
                    designTimeHtml = GetErrorDesignTimeHtml(ex)

                    ' Return properties to their original settings.
                Finally
                    sampleButton.BorderStyle = oldBorderStyle
                    sampleButton.BorderWidth = oldBorderWidth
                    sampleButton.BorderColor = oldBorderColor
                End Try

            Else
                designTimeHtml = MyBase.GetDesignTimeHtml()
            End If

            Return designTimeHtml

        End Function

    End Class
End Namespace

Hinweise

Die GetDesignTimeHtml -Methode ersetzt die Text -Eigenschaft durch die ID -Eigenschaft des Button -Steuerelements, wenn der Text keine anzeigbaren Zeichen enthält. Anschließend ruft die GetDesignTimeHtml -Methode ihre Basismethode auf, ControlDesigner.GetDesignTimeHtmldie die Control.RenderControl -Methode aufruft, um das Markup zu generieren.

Hinweise für Vererber

Wenn Sie die -Methode überschreiben, ändern Sie in der GetDesignTimeHtml() Regel ausgewählte Eigenschaftswerte, rufen dann die Basismethode auf, um das Markup zu generieren, und stellen Sie dann die Eigenschaften auf ihre ursprünglichen Werte wieder her.

Gilt für:

Freigeben über