ControlDesigner.GetEmptyDesignTimeHtml 메서드

정의

네임스페이스:

System.Web.UI.Design

어셈블리:

System.Design.dll

런타임 시 시각적으로 표시되지 않는 웹 서버 컨트롤을 디자인 타임에 나타내는 HTML 태그를 가져옵니다.

protected:
 virtual System::String ^ GetEmptyDesignTimeHtml();

protected virtual string GetEmptyDesignTimeHtml ();

abstract member GetEmptyDesignTimeHtml : unit -> string
override this.GetEmptyDesignTimeHtml : unit -> string

Protected Overridable Function GetEmptyDesignTimeHtml () As String

반환

String

시각적으로 표시되지 않을 컨트롤을 디자인 타임에 나타내는 데 사용되는 HTML 태그입니다. 기본값은 구성 요소의 형식 및 ID를 포함하는 사각형입니다.

예제

다음 코드 예제에서는 사용자 지정 컨트롤 디자이너에서 메서드를 재정의 GetDesignTimeHtml 하는 방법을 보여 줍니다. 연결된 컨트롤의 Text 속성이 비어 있으면 메서드는 메서드를 GetDesignTimeHtml 호출합니다 GetEmptyDesignTimeHtml . 그렇지 않으면 메서드가 GetDesignTimeHtml 컨트롤을 만들고 렌더링합니다 Hyperlink .

public override string GetDesignTimeHtml()
{
    if (simpleControl.Text.Length > 0)
    {
        string spec = "<a href='{0}.aspx'>{0}</a>";
        return String.Format(spec, simpleControl.Text);
    }
    else
    {
        return GetEmptyDesignTimeHtml();
    }
}

Public Overrides Function GetDesignTimeHtml() As String
   ' Component is the instance of the component or control that
   ' this designer object is associated with. This property is 
   ' inherited from System.ComponentModel.ComponentDesigner.
   simpleControl = CType(Component, Simple)
   
   If simpleControl.Text.Length > 0 Then
      Dim sw As New StringWriter()
      Dim tw As New HtmlTextWriter(sw)
      
      Dim placeholderLink As New HyperLink()
      
      ' Put simpleControl.Text into the link's Text.
      placeholderLink.Text = simpleControl.Text
      placeholderLink.NavigateUrl = simpleControl.Text
      placeholderLink.RenderControl(tw)
      
      Return sw.ToString()
   Else
      Return GetEmptyDesignTimeHtml()
   End If
End Function

설명

메서드의 GetEmptyDesignTimeHtml 기본 동작은 구성 요소의 이름을 포함하는 문자열을 반환하는 것입니다. GetEmptyDesignTimeHtml 디자인 타임 HTML 태그가 없는 경우 메서드 구현 GetDesignTimeHtml 에서 메서드를 호출해야 합니다.

추가 정보

• GetErrorDesignTimeHtml(Exception)
• GetDesignTimeHtml
• ASP.NET 컨트롤 디자이너 개요