HyperLinkDesigner.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

디자인 타임에 관련 하이퍼링크 컨트롤을 렌더링하는 데 사용되는 태그를 포함한 문자열입니다.

예제

다음 코드 예제에서는 클래스에서 클래스를 파생 하는 CustomHyperLinkDesigner 방법을 보여 있습니다 HyperLinkDesigner . 원래 값이 GetDesignTimeHtml 빈 문자열("")인 경우 속성에 대한 Text 기본값을 제공하도록 메서드를 Text 재정의합니다. 이렇게 하면 연결된 컨트롤이 디자인 타임에 표시됩니다.

이 코드 예제는에 대해 제공 된 큰 예제의 일부는 HyperLinkDesigner 클래스입니다.

// Derive the CustomHyperLinkDesigner from the HyperLinkDesigner.
public class CustomHyperLinkDesigner : HyperLinkDesigner
{
    // Override the GetDesignTimeHtml to set the CustomHyperLink Text 
    // property so that it displays at design time.
    public override string GetDesignTimeHtml()
    {
        CustomHyperLink hype = (CustomHyperLink)Component;
        string designTimeMarkup = null;

        // Save the original Text and note if it is empty.
        string text = hype.Text;
        bool noText = (text.Trim().Length == 0);

        try
        {
            // If the Text is empty, supply a default value.
            if (noText)
                hype.Text = "Click here.";

            // Call the base method to generate the markup.
            designTimeMarkup = base.GetDesignTimeHtml();
        }
        catch (Exception ex)
        {
            // If an error occurs, generate the markup for an error message.
            designTimeMarkup = GetErrorDesignTimeHtml(ex);
        }
        finally
        {
            // Restore the original value of the Text, if necessary.
            if (noText)
                hype.Text = text;
        }

        // If the markup is empty, generate the markup for a placeholder.
        if(designTimeMarkup == null || designTimeMarkup.Length == 0)
            designTimeMarkup = GetEmptyDesignTimeHtml();

        return designTimeMarkup;
    } // GetDesignTimeHtml
} // CustomHyperLinkDesigner

' Derive the CustomHyperLinkDesigner from the HyperLinkDesigner.
Public Class CustomHyperLinkDesigner
    Inherits HyperLinkDesigner

    ' Override the GetDesignTimeHtml to set the CustomHyperLink Text
    ' property so that it displays at design time.
    Public Overrides Function GetDesignTimeHtml() As String

        Dim hype As CustomHyperLink = CType(Component, CustomHyperLink)
        Dim designTimeMarkup As String = Nothing

        ' Save the original Text and note if it is empty.
        Dim text As String = hype.Text
        Dim noText As Boolean = (text.Trim().Length = 0)

        Try
            ' If the Text is empty, supply a default value.
            If noText Then
                hype.Text = "Click here."
            End If

            ' Call the base method to generate the markup.
            designTimeMarkup = MyBase.GetDesignTimeHtml()

        Catch ex As Exception
            ' If an error occurs, generate the markup for an error message.
            designTimeMarkup = GetErrorDesignTimeHtml(ex)

        Finally
            ' Restore the original value of the Text, if necessary.
            If noText Then
                hype.Text = text
            End If
        End Try

        ' If the markup is empty, generate the markup for a placeholder.
        If ((designTimeMarkup = Nothing) Or _
            (designTimeMarkup.Length = 0)) Then
            designTimeMarkup = GetEmptyDesignTimeHtml()
        End If

        Return designTimeMarkup

    End Function ' GetDesignTimeHtml
End Class

설명

이 메서드는 GetDesignTimeHtml 연결된 HyperLink 컨트롤에 대한 디자인 타임 태그를 생성합니다. 이 메서드는 먼저 자식 컬렉션뿐만 아니라 , NavigateUrl및 ImageUrl 속성의 Text로컬 복사본을 Controls 저장합니다. 원래 값이 비어 있거나 비어 있는 경우 이러한 속성에 대한 기본값을 null 제공합니다. 그런 다음, 메서드는 GetDesignTimeHtml 기본 메서드를 호출 GetDesignTimeHtml 하여 태그를 생성하고 필요한 경우 속성 및 자식 컨트롤 컬렉션을 원래 값으로 복원합니다.

추가 정보

• HyperLink
• GetDesignTimeHtml()
• ControlDesigner