ButtonDesigner.GetDesignTimeHtml Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u de opmaak op die wordt gebruikt om het bijbehorende besturingselement op het ontwerptijd weer te geven.
public:
override System::String ^ GetDesignTimeHtml();public override string GetDesignTimeHtml();override this.GetDesignTimeHtml : unit -> stringPublic Overrides Function GetDesignTimeHtml () As StringRetouren
Een String met de opmaak die wordt gebruikt om de Button ontwerptijd weer te geven.
Voorbeelden
In het volgende codevoorbeeld ziet u hoe u de GetDesignTimeHtml methode overschrijft om de gegenereerde markeringen te wijzigen.
Als de BorderStyle eigenschap nog niet eerder is ingesteld (dat wil gezegd, de veldwaarde heeft NotSet ), wordt deze door een aanroep van de GetDesignTimeHtml methode ingesteld op een blauwe rand met een breedte van drie pixels en wordt die rand vervolgens weergegeven op het ontwerpoppervlak. Als de BorderStyle eigenschap is ingesteld, worden de waarden van de bestaande randeigenschap weergegeven.
Normaal gesproken roept de GetDesignTimeHtml basismethode aan, ControlDesigner.GetDesignTimeHtmldie de Control.RenderControl methode van het gekoppelde besturingselement aanroept om de opmaak te genereren.
' 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
Opmerkingen
De GetDesignTimeHtml methode vervangt de Text eigenschap door de ID eigenschap van het Button besturingselement als het Text geen weergavebare tekens bevat. Vervolgens roept de methode de GetDesignTimeHtml basismethode aan, ControlDesigner.GetDesignTimeHtmldie de Control.RenderControl methode aanroept om de opmaak te genereren.
Notities voor overnemers
Als u de GetDesignTimeHtml() methode overschrijft, wijzigt u doorgaans geselecteerde eigenschapswaarden, roept u de basismethode aan om de markering te genereren en herstelt u de eigenschappen vervolgens naar de oorspronkelijke waarden.
