ButtonDesigner.GetDesignTimeHtml Metoda

Reference

Definice

Obor názvů:: System.Web.UI.Design.WebControls

Sestavení:: System.Design.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá kód, který se používá k vykreslení přidruženého ovládacího prvku v době návrhu.

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

public override string GetDesignTimeHtml ();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

Návraty

String

A String obsahující kód použitý k vykreslení v době návrhu Button .

Příklady

Následující příklad kódu ukazuje, jak přepsat metodu GetDesignTimeHtml změnit vygenerovaný kód.

BorderStyle Pokud vlastnost nebyla dříve nastavena (to znamená, že má NotSet hodnotu pole), volání GetDesignTimeHtml metody ji nastaví na modře přerušované ohraničení o šířce tři pixely a poté zobrazí toto ohraničení na návrhové ploše. Pokud je BorderStyle vlastnost nastavená, zobrazí se existující hodnoty vlastnosti ohraničení.

Obvykle volá svou základní metodu GetDesignTimeHtml , ControlDesigner.GetDesignTimeHtmlkterá volá metodu Control.RenderControl přidruženého ovládacího prvku k vygenerování kódu.

' 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

Poznámky

Metoda GetDesignTimeHtml nahradí Text vlastnost ID vlastností Button ovládacího prvku, pokud neobsahuje Text žádné zobrazované znaky. GetDesignTimeHtml Pak metoda volá svou základní metodu , ControlDesigner.GetDesignTimeHtmlkterá volá metodu Control.RenderControl pro vygenerování kódu.

Poznámky pro dědice

Pokud přepíšete metodu GetDesignTimeHtml() , obvykle upravíte vybrané hodnoty vlastností, zavoláte základní metodu, která vygeneruje značky, a poté obnovíte vlastnosti na původní hodnoty.

Platí pro

Sdílet prostřednictvím