LoginViewDesigner.GetDesignTimeHtml 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得用於設計時渲染相關 LoginView 控制項的標記。
多載
| 名稱 | Description |
|---|---|
| GetDesignTimeHtml() |
取得用於設計時渲染相關控制項的標記。 |
| GetDesignTimeHtml(DesignerRegionCollection) |
取得用於設計時渲染相關控制項的標記,並填充一組設計師區域。 |
GetDesignTimeHtml()
取得用於設計時渲染相關控制項的標記。
public:
override System::String ^ GetDesignTimeHtml();
public override string GetDesignTimeHtml();
override this.GetDesignTimeHtml : unit -> string
Public Overrides Function GetDesignTimeHtml () As String
傳回
包含標記的字串,用於在設計時渲染 。LoginView
範例
以下程式碼範例說明如何覆寫 GetDesignTimeHtml 從該類別繼承 LoginViewDesigner 的方法,以改變設計時從類別衍生出 LoginView 的控制項外觀。 範例中在控制點周圍畫了橘色邊框,使其範圍更明顯。
// Generate the design-time markup.
public override string GetDesignTimeHtml(DesignerRegionCollection regions)
{
// Make the control more visible in the designer.
// Enclose the markup in a table with an orange border.
const string openTableMarkup =
"<table><tr><td style=\"border:4 solid #FF7F00;\">";
const string closeTableMarkup = "</td></tr></table>";
// Call the base method to generate the markup.
string markup = base.GetDesignTimeHtml(regions);
return openTableMarkup + markup + closeTableMarkup;
} // GetDesignTimeHtml
' Generate the design-time markup.
Public Overrides Function GetDesignTimeHtml( _
ByVal regions As DesignerRegionCollection) As String
' Make the control more visible in the designer.
' Enclose the markup in a table with an orange border.
Dim openTableMarkup As String = _
"<table><tr><td style=""border:4 solid #FF7F00;"">"
Dim closeTableMarkup As String = "</td></tr></table>"
' Call the base method to generate the markup.
Dim markup As String = MyBase.GetDesignTimeHtml(regions)
Return openTableMarkup & markup & closeTableMarkup
End Function ' GetDesignTimeHtml
備註
該 GetDesignTimeHtml 方法會將相關 LoginView 控制項的範本索引設為目前的設計時索引,然後在必要時,讓相關控制項重新建立並進行資料綁定。 接著,呼叫GetDesignTimeHtmlGetDesignTimeHtml基礎方法來產生標記。
給繼承者的注意事項
如果你覆寫了該方法, GetDesignTimeHtml() 務必呼叫 GetDesignTimeHtml() 基礎方法,因為它最終會透過多次覆寫層級呼叫 LoginView 控制項或控制項的副本來產生標記。
另請參閱
適用於
GetDesignTimeHtml(DesignerRegionCollection)
取得用於設計時渲染相關控制項的標記,並填充一組設計師區域。
public:
override System::String ^ GetDesignTimeHtml(System::Web::UI::Design::DesignerRegionCollection ^ regions);
public override string GetDesignTimeHtml(System.Web.UI.Design.DesignerRegionCollection regions);
override this.GetDesignTimeHtml : System.Web.UI.Design.DesignerRegionCollection -> string
Public Overrides Function GetDesignTimeHtml (regions As DesignerRegionCollection) As String
參數
- regions
- DesignerRegionCollection
DesignerRegionCollection在設計時視圖LoginView中,新增可選與可點擊區域的定義。
傳回
包含標記的字串,用於在設計時渲染 。LoginView
範例
以下程式碼範例說明如何覆寫 GetDesignTimeHtml 從該類別繼承 LoginViewDesigner 的方法,以改變設計時從類別衍生出 LoginView 的控制項外觀。 範例中在控制點周圍畫了橘色邊框,使其範圍更明顯。
// Generate the design-time markup.
public override string GetDesignTimeHtml(DesignerRegionCollection regions)
{
// Make the control more visible in the designer.
// Enclose the markup in a table with an orange border.
const string openTableMarkup =
"<table><tr><td style=\"border:4 solid #FF7F00;\">";
const string closeTableMarkup = "</td></tr></table>";
// Call the base method to generate the markup.
string markup = base.GetDesignTimeHtml(regions);
return openTableMarkup + markup + closeTableMarkup;
} // GetDesignTimeHtml
' Generate the design-time markup.
Public Overrides Function GetDesignTimeHtml( _
ByVal regions As DesignerRegionCollection) As String
' Make the control more visible in the designer.
' Enclose the markup in a table with an orange border.
Dim openTableMarkup As String = _
"<table><tr><td style=""border:4 solid #FF7F00;"">"
Dim closeTableMarkup As String = "</td></tr></table>"
' Call the base method to generate the markup.
Dim markup As String = MyBase.GetDesignTimeHtml(regions)
Return openTableMarkup & markup & closeTableMarkup
End Function ' GetDesignTimeHtml
備註
此 GetDesignTimeHtml 方法會在視覺設計器表面建立 EditableDesignerRegion 一個模板編輯區域的物件,然後將其初始化為範本。 若未定義範本,會顯示一個字串提示你點擊開始編輯。 使用預先定義的常數來產生回傳的標記。
給繼承者的注意事項
此 GetDesignTimeHtml(DesignerRegionCollection) 過載不會呼叫其基礎方法或 LoginView 控制項來產生標記。