LoginViewDesigner.GetDesignTimeHtml 方法

定義

命名空間:

System.Web.UI.Design.WebControls

組件:

System.Design.dll

取得在設計階段用來呈現相關聯 LoginView 控制項的標記。

多載

GetDesignTimeHtml()	取得在設計階段用來呈現關聯控制項的標記。
GetDesignTimeHtml(DesignerRegionCollection)	取得標記，此標記可用來在設計階段呈現關聯控制項，並填入設計工具區域的集合中。

GetDesignTimeHtml()

取得在設計階段用來呈現關聯控制項的標記。

public:
 override System::String ^ GetDesignTimeHtml();

public override string GetDesignTimeHtml ();

override this.GetDesignTimeHtml : unit -> string

Public Overrides Function GetDesignTimeHtml () As String

傳回

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 控制項的樣板索引設定為目前的設計階段索引，然後在必要時讓相關聯的控制項重新建立和資料系結其子控制項。 接下來，會 GetDesignTimeHtml 呼叫 GetDesignTimeHtml 基底方法來產生標記。

給繼承者的注意事項

如果您覆寫 GetDesignTimeHtml() 方法，請務必呼叫 GetDesignTimeHtml() 基底方法，因為它最終會透過數個覆寫層級、對 LoginView 控制項呼叫或控制項的複本來產生標記。

另請參閱

• LoginView
• SetDesignModeState(IDictionary)

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 設計階段檢視中的可選取及可按一下區域之定義。

傳回

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方法會在 EditableDesignerRegion 視覺化設計工具介面上建立範本編輯區域的物件，然後將它初始化為範本。 如果未定義任何範本，就會顯示字串，提示您按一下以開始編輯。 預先定義的常數是用來產生傳回的標記。

給繼承者的注意事項

這個 GetDesignTimeHtml(DesignerRegionCollection) 多載不會在其基底方法或 LoginView 控制項上呼叫以產生標記。

另請參閱

• LoginView
• EditableDesignerRegion
• DesignerRegionCollection