Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo ButtonDesigner.GetDesignTimeHtml ()

 

Data di pubblicazione: ottobre 2016

Ottiene il markup usato per il rendering del controllo associato in fase di progettazione.

Spazio dei nomi:   System.Web.UI.Design.WebControls
Assembly:  System.Design (in System.Design.dll)

public override string GetDesignTimeHtml()

Valore restituito

Type: System.String

Oggetto String contenente il markup usato per eseguire il rendering dell'oggetto Button in fase di progettazione.

Il GetDesignTimeHtml metodo sostituisce il Text proprietà con il ID proprietà del Button controllare se il Text non contiene caratteri visualizzabili. Quindi, GetDesignTimeHtml metodo chiama il metodo di base, ControlDesigner.GetDesignTimeHtml, che chiama il Control.RenderControl metodo per generare il markup.

Note per gli eredi:

Se si esegue l'override di GetDesignTimeHtml (metodo), in genere verrà modificano i valori di proprietà selezionata, quindi chiamare il metodo di base per generare il markup e ripristinare le proprietà sui valori originali.

Esempio di codice riportato di seguito viene illustrato come eseguire l'override di GetDesignTimeHtml per modificare il markup generato.

Se il BorderStyle proprietà non è stata impostata in precedenza (che ha il NotSet valore del campo), una chiamata al GetDesignTimeHtml metodo lo imposta su un bordo tratteggiato blu con una larghezza pari a tre pixel e quindi tale bordo viene visualizzato nell'area di progettazione. Se il BorderStyle proprietà è stata impostata, vengono visualizzati i valori di proprietà esistenti del bordo.

In genere, il GetDesignTimeHtml chiama il metodo di base, ControlDesigner.GetDesignTimeHtml, che chiama il Control.RenderControl metodo del controllo associato per generare il markup.

' Create a class that derives from ButtonDesigner
' and displays the custom SampleButton control
' on the design surface.
Imports System
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

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: