ControlDesigner.CreatePlaceHolderDesignTimeHtml 方法

定義

命名空間:

System.Web.UI.Design

組件:

System.Design.dll

提供簡單矩形預留位置表示，顯示控制項的型別和 ID。

多載

CreatePlaceHolderDesignTimeHtml()	提供簡單矩形預留位置表示，顯示控制項的型別和 ID。
CreatePlaceHolderDesignTimeHtml(String)	提供簡單矩形預留位置表示，顯示控制項的型別和 ID，以及其他指定的指示或資訊。

CreatePlaceHolderDesignTimeHtml()

提供簡單矩形預留位置表示，顯示控制項的型別和 ID。

protected:
 System::String ^ CreatePlaceHolderDesignTimeHtml();

protected string CreatePlaceHolderDesignTimeHtml ();

member this.CreatePlaceHolderDesignTimeHtml : unit -> string

Protected Function CreatePlaceHolderDesignTimeHtml () As String

傳回

String

包含設計階段 HTML 標記的字串，提供有關控制項的基本資訊。

給繼承者的注意事項

典型的設計模式是嘗試透過相關聯的控件取得 HTML 標記，然後如果遇到錯誤，請呼叫 GetErrorDesignTimeHtml(Exception) 方法。 如果控件未傳回任何標記，請呼叫 GetEmptyDesignTimeHtml() 方法，如果未覆寫以提供特定標記，則會呼叫 CreatePlaceHolderDesignTimeHtml() 方法，該方法應該包含控件的類型和標識符的相關信息。

另請參閱

• ASP.NET 控件設計工具概觀

CreatePlaceHolderDesignTimeHtml(String)

提供簡單矩形預留位置表示，顯示控制項的型別和 ID，以及其他指定的指示或資訊。

protected:
 System::String ^ CreatePlaceHolderDesignTimeHtml(System::String ^ instruction);

protected string CreatePlaceHolderDesignTimeHtml (string instruction);

member this.CreatePlaceHolderDesignTimeHtml : string -> string

Protected Function CreatePlaceHolderDesignTimeHtml (instruction As String) As String

參數

instruction

String

字串，包含要加入至 HTML 輸出的文字和標記。

傳回

String

包含設計階段 HTML 標記的字串，提供有關控制項的資訊。

範例

下列程式代碼範例示範如何在樣板化控件設計工具中覆寫 GetDesignTimeHtml 方法。 接著，字串會在呼叫 CreatePlaceHolderDesignTimeHtml 方法中當做 instruction 參數傳遞，以提供設計時間的 HTML 標記。

此程式代碼範例是針對 屬性提供的較大範例的 TemplateGroups 一部分。

// Add instructions to the placeholder view of the control
public override string GetDesignTimeHtml()
{
    return CreatePlaceHolderDesignTimeHtml("Click here and use " +
        "the task menu to edit the templates.");
}

' Add instructions to the placeholder view of the control
Public Overloads Overrides Function GetDesignTimeHtml() As String
    Return CreatePlaceHolderDesignTimeHtml("Click here and use " & _
        "the task menu to edit the templates.")
End Function

給繼承者的注意事項

典型的設計模式是嘗試透過相關聯的控件取得 HTML 標記，然後如果遇到錯誤，請呼叫 GetErrorDesignTimeHtml(Exception) 方法。 如果控件未傳回任何標記，請呼叫 GetEmptyDesignTimeHtml() 方法，如果未覆寫以提供特定標記，則會呼叫 CreatePlaceHolderDesignTimeHtml() 方法，該方法應該包含控件的類型和標識符的相關信息。

另請參閱

• ASP.NET 控件設計工具概觀