Aracılığıyla paylaş

ButtonDesigner.GetDesignTimeHtml Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.Design.WebControls
Bütünleştirilmiş Kod:
System.Design.dll

Tasarım zamanında ilişkili denetimi işlemek için kullanılan işaretlemeyi alır.

public:
 override System::String ^ GetDesignTimeHtml();
public override string GetDesignTimeHtml ();
override this.GetDesignTimeHtml : unit -> string
Public Overrides Function GetDesignTimeHtml () As String

Döndürülenler

String

String Tasarım zamanında işlemek için kullanılan işaretlemeyi Button içeren.

Örnekler

Aşağıdaki kod örneği, oluşturulan işaretlemeyi GetDesignTimeHtml değiştirmek için yönteminin nasıl geçersiz kılınduğunu gösterir.

BorderStyle Özellik daha önce ayarlanmamışsa (yani alan değerine sahipseNotSet), yöntemine yapılan GetDesignTimeHtml bir çağrı bunu üç piksel genişliğinde mavi kesikli bir kenarlık olarak ayarlar ve ardından bu kenarlık tasarım yüzeyinde görüntülenir. BorderStyle Özellik ayarlandıysa, mevcut kenarlık özelliği değerleri görüntülenir.

Genellikle, işaretlemeyi GetDesignTimeHtml oluşturmak için ilişkili denetimin Control.RenderControl yöntemine çağıran temel yöntemini ControlDesigner.GetDesignTimeHtmlçağırır.

' 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

Açıklamalar

yöntemi, GetDesignTimeHtml görüntülenebilir karakter içermiyorsa özelliğini denetimin ButtonText özelliğiyle ID değiştirirText. Ardından yöntemi, GetDesignTimeHtml işaretlemeyi oluşturmak için yöntemine Control.RenderControl çağıran temel yöntemini ControlDesigner.GetDesignTimeHtmlçağırır.

Devralanlara Notlar

yöntemini geçersiz kılıyorsanız GetDesignTimeHtml() , genellikle seçili özellik değerlerini değiştirir, ardından işaretlemeyi oluşturmak için temel yöntemi çağırır ve ardından özellikleri özgün değerlerine geri yüklersiniz.

Şunlara uygulanır

Ayrıca bkz.