ControlDesigner.GetEmptyDesignTimeHtml 方法

定義

命名空間:

System.Web.UI.Design

組件:

System.Design.dll

擷取 HTML 標記，以在設計階段呈現在執行階段沒有視覺表示的 Web 伺服器控制項。

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 標記，用來在設計階段呈現沒有視覺表示的控制項。 預設值是一個包含元件類型和識別碼的矩形。

範例

下列程式代碼範例示範如何在自定義控件設計工具中覆寫 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 控件設計工具概觀