ButtonDesigner.GetDesignTimeHtml Metoda
Definice
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á revize, 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
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é revize.
BorderStyle Pokud vlastnost nebyla dříve nastavena (to znamená, že má NotSet hodnotu pole), volání GetDesignTimeHtml metody nastaví na modré přerušované ohraničení s šířkou tří pixelů a pak zobrazí toto ohraničení na návrhové ploše. BorderStyle Pokud je vlastnost nastavena, zobrazí se existující hodnoty vlastností ohraničení.
GetDesignTimeHtml Obvykle volá svou základní metodu, ControlDesigner.GetDesignTimeHtmlkterá volá metodu Control.RenderControl přidruženého ovládacího prvku ke generování revizí.
' 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á do Control.RenderControl metody k vygenerování kódu.
Poznámky pro dědice
Pokud přepíšete metodu GetDesignTimeHtml() , obvykle upravíte vybrané hodnoty vlastností, pak zavoláte základní metodu pro vygenerování kódu a potom obnovíte vlastnosti na jejich původní hodnoty.