ButtonDesigner.GetDesignTimeHtml 메서드

정의

네임스페이스:

System.Web.UI.Design.WebControls

어셈블리:

System.Design.dll

디자인 타임에, 연결된 컨트롤을 렌더링하는 데 사용되는 태그를 가져옵니다.

public:
 override System::String ^ GetDesignTimeHtml();

public override string GetDesignTimeHtml ();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

반환

String

디자인 타임에 Button을(를) 렌더링하는 데 사용되는 태그가 포함된 String입니다.

예제

다음 코드 예제에서는 재정의 하는 방법에 설명 합니다 GetDesignTimeHtml 생성된 된 태그를 변경 하는 방법입니다.

경우는 BorderStyle 속성이 이전에 설정 되지 않은 (즉,에 NotSet 필드 값)에 대 한 호출을 GetDesignTimeHtml 메서드 파란색 파선 테두리의 세 가지 픽셀 너비를 설정 하 고 다음 디자인 화면에서 해당 테두리를 표시 합니다. 경우는 BorderStyle 속성이 설정 되어, 기존 테두리 속성 값이 표시 됩니다.

일반적으로 GetDesignTimeHtml 해당 기본 메서드를 호출 ControlDesigner.GetDesignTimeHtml를 호출 하는 Control.RenderControl 태그를 생성 하려면 연결된 된 컨트롤의 메서드.

' 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

설명

GetDesignTimeHtml 메서드 대체를 Text 속성을는 ID 의 속성을 Button 제어는 Text 표시할 수 있는 문자를 포함 합니다. 그런 다음, GetDesignTimeHtml 메서드는 기본 메서드를 호출 ControlDesigner.GetDesignTimeHtml를 호출 하는 Control.RenderControl 태그를 생성 하는 방법입니다.

상속자 참고

재정의 하는 경우는 GetDesignTimeHtml() 메서드를 일반적으로 선택한 속성 값을 수정 다음 태그를 생성 하기 위한 기본 메서드 호출을 다음 원래 값으로 속성을 복원 합니다.

추가 정보

• Button
• GetDesignTimeHtml()
• RenderControl(HtmlTextWriter)
• ASP.NET 컨트롤 디자이너 소개
• 연습: 웹 서버 컨트롤에 대 한 기본 컨트롤 디자이너 만들기