ButtonDesigner.GetDesignTimeHtml Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar den markering som används för att återge den associerade kontrollen vid designtillfället.
public:
override System::String ^ GetDesignTimeHtml();public override string GetDesignTimeHtml();override this.GetDesignTimeHtml : unit -> stringPublic Overrides Function GetDesignTimeHtml () As StringReturer
En String som innehåller den markering som används för att återge vid Button designtillfället.
Exempel
I följande kodexempel visas hur du åsidosätter GetDesignTimeHtml metoden för att ändra den genererade markeringen.
Om egenskapen BorderStyle inte har angetts tidigare (det vill säga att den NotSet har fältvärdet) anger ett anrop till GetDesignTimeHtml metoden den till en blåstreckad kantlinje med en bredd på tre bildpunkter och visar sedan den kantlinjen på designytan. Om egenskapen BorderStyle har angetts visas de befintliga gränsegenskapsvärdena.
GetDesignTimeHtml Normalt anropar dess basmetod, ControlDesigner.GetDesignTimeHtml, som anropar metoden för den Control.RenderControl associerade kontrollen för att generera pålägget.
' 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
Kommentarer
Metoden GetDesignTimeHtml ersätter Text egenskapen med ID egenskapen för Button kontrollen om den Text inte innehåller några tecken som kan visas. GetDesignTimeHtml Sedan anropar metoden dess basmetod, ControlDesigner.GetDesignTimeHtml, som anropar Control.RenderControl metoden för att generera markering.
Anteckningar till arvingar
Om du åsidosätter GetDesignTimeHtml() metoden ändrar du vanligtvis valda egenskapsvärden, anropar sedan basmetoden för att generera markering och återställer sedan egenskaperna till sina ursprungliga värden.
