Udostępnij za pośrednictwem

ButtonDesigner.GetDesignTimeHtml Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.Design.WebControls
Zestaw:
System.Design.dll

Pobiera znaczniki używane do renderowania skojarzonej kontrolki w czasie projektowania.

public:
 override System::String ^ GetDesignTimeHtml();
public override string GetDesignTimeHtml ();
override this.GetDesignTimeHtml : unit -> string
Public Overrides Function GetDesignTimeHtml () As String

Zwraca

String

Element String zawierający znaczniki używane do renderowania Button w czasie projektowania.

Przykłady

W poniższym przykładzie kodu pokazano, jak zastąpić metodę GetDesignTimeHtml w celu zmiany wygenerowanego znaczników.

BorderStyle Jeśli właściwość nie została wcześniej ustawiona (czyli ma NotSet wartość pola), wywołanie GetDesignTimeHtml metody ustawia jej na obramowanie kreskowane niebiesko-kreskowane o szerokości trzech pikseli, a następnie wyświetla tę krawędź na powierzchni projektowej. BorderStyle Jeśli właściwość została ustawiona, zostaną wyświetlone istniejące wartości właściwości obramowania.

Zazwyczaj metoda podstawowa GetDesignTimeHtml wywołuje metodę , ControlDesigner.GetDesignTimeHtmlktóra wywołuje Control.RenderControl metodę skojarzonej kontrolki w celu wygenerowania znaczników.

' 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

Uwagi

Metoda GetDesignTimeHtml zastępuje Text właściwość ID właściwością kontrolki Button , jeśli element Text nie zawiera znaków wyświetlanych. GetDesignTimeHtml Następnie metoda wywołuje metodę podstawową , ControlDesigner.GetDesignTimeHtmlktóra wywołuje metodę w Control.RenderControl celu wygenerowania znaczników.

Uwagi dotyczące dziedziczenia

Jeśli zastępujesz metodę GetDesignTimeHtml() , zazwyczaj zmodyfikujesz wybrane wartości właściwości, wywołaj metodę podstawową, aby wygenerować znaczniki, a następnie przywrócisz właściwości do ich oryginalnych wartości.

Dotyczy

Zobacz też