ControlDesigner.GetDesignTimeHtml Methode

Definition

Ruft das HTML-Markup ab, das für die Darstellung des Steuerelements zur Entwurfszeit verwendet wird.Retrieves the HTML markup that is used to represent the control at design time.

Überlädt

GetDesignTimeHtml(DesignerRegionCollection)

Ruft das HTML-Markup zum Anzeigen des Steuerelements ab und füllt die Auflistung mit den aktuellen Steuerelement-Designer-Bereichen auf.Retrieves the HTML markup to display the control and populates the collection with the current control designer regions.

GetDesignTimeHtml()

Ruft das HTML-Markup ab, das für die Darstellung des Steuerelements zur Entwurfszeit verwendet wird.Retrieves the HTML markup that is used to represent the control at design time.

GetDesignTimeHtml(DesignerRegionCollection)

Ruft das HTML-Markup zum Anzeigen des Steuerelements ab und füllt die Auflistung mit den aktuellen Steuerelement-Designer-Bereichen auf.Retrieves the HTML markup to display the control and populates the collection with the current control designer regions.

public:
 virtual System::String ^ GetDesignTimeHtml(System::Web::UI::Design::DesignerRegionCollection ^ regions);
public virtual string GetDesignTimeHtml (System.Web.UI.Design.DesignerRegionCollection regions);
abstract member GetDesignTimeHtml : System.Web.UI.Design.DesignerRegionCollection -> string
override this.GetDesignTimeHtml : System.Web.UI.Design.DesignerRegionCollection -> string
Public Overridable Function GetDesignTimeHtml (regions As DesignerRegionCollection) As String

Parameter

regions
DesignerRegionCollection

Eine Auflistung von Steuerelement-Designer-Bereichen für das zugeordnete Steuerelement.A collection of control designer regions for the associated control.

Gibt zurück

String

Das HTML-Entwurfszeitmarkup für das zugeordnete Steuerelement, einschließlich aller Steuerelement-Designer-Bereiche.The design-time HTML markup for the associated control, including all control designer regions.

Beispiele

Im folgenden Codebeispiel wird gezeigt, wie HTML-Markup mithilfe der-Auflistung erstellt wird DesignerRegionCollection .The following code example shows how to create HTML markup using the DesignerRegionCollection collection.

// Create the regions and design-time markup. Called by the designer host.
public override String GetDesignTimeHtml(DesignerRegionCollection regions) {
    // Create 3 regions: 2 clickable headers and an editable row
    regions.Add(new DesignerRegion(this, "Header0"));
    regions.Add(new DesignerRegion(this, "Header1"));

    // Create an editable region and add it to the regions
    EditableDesignerRegion editableRegion = 
        new EditableDesignerRegion(this, 
            "Content" + myControl.CurrentView, false);
    regions.Add(editableRegion);

    // Set the highlight for the selected region
    regions[myControl.CurrentView].Highlight = true;

    // Use the base class to render the markup
    return base.GetDesignTimeHtml();
}
' Create the regions and design-time markup. Called by the designer host.
Public Overrides Function GetDesignTimeHtml(ByVal regions As DesignerRegionCollection) As String
    ' Create 3 regions: 2 clickable headers and an editable row
    regions.Add(New DesignerRegion(Me, "Header0"))
    regions.Add(New DesignerRegion(Me, "Header1"))

    ' Create an editable region and add it to the regions
    Dim editableRegion As EditableDesignerRegion = _
        New EditableDesignerRegion(Me, _
            "Content" & myControl.CurrentView, False)
    regions.Add(editableRegion)

    ' Set the highlight for the selected region
    regions(myControl.CurrentView).Highlight = True

    ' Use the base class to render the markup
    Return MyBase.GetDesignTimeHtml()
End Function

Hinweise

Der Entwurfs Host ruft die GetDesignTimeHtml -Methode auf, um das Entwurfszeit-HTML-Markup und die aktuelle Liste der Steuerelement-Designer-Bereiche zu erhalten.The design host calls the GetDesignTimeHtml method to get the design-time HTML markup and the current list of control designer regions. Mithilfe der DesignerRegionCollection kann der Entwurfs Host dann das Markup für jeden bearbeitbaren Steuerelement-Designer-Bereich anfordern.Using the DesignerRegionCollection, the design host can then request the markup for each editable control designer region.

Die- GetDesignTimeHtml Methode wird für einen abgeleiteten Steuerelement-Designer bereitgestellt, z. b. die- GridViewDesigner Klasse, der den Inhalt für den Bereich vor dem Aufrufen der-Methode verarbeiten muss GetDesignTimeHtml .The GetDesignTimeHtml method is provided for a derived control designer, such as the GridViewDesigner class, that must process the content for the region before calling the GetDesignTimeHtml method.

Siehe auch

Gilt für:

GetDesignTimeHtml()

Ruft das HTML-Markup ab, das für die Darstellung des Steuerelements zur Entwurfszeit verwendet wird.Retrieves the HTML markup that is used to represent the control at design time.

public:
 virtual System::String ^ GetDesignTimeHtml();
public virtual string GetDesignTimeHtml ();
abstract member GetDesignTimeHtml : unit -> string
override this.GetDesignTimeHtml : unit -> string
Public Overridable Function GetDesignTimeHtml () As String

Gibt zurück

String

Das HTML-Markup, das für die Darstellung des Steuerelements zur Entwurfszeit verwendet wird.The HTML markup used to represent the control at design time.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die- GetDesignTimeHtml Methode in einem benutzerdefinierten Steuerelement-Designer überschrieben wird.The following code example demonstrates how to override the GetDesignTimeHtml method in a custom control designer. Wenn die Text-Eigenschaft für das zugeordnete Steuerelement leer ist, ruft die- GetDesignTimeHtml Methode die- GetEmptyDesignTimeHtml Methode auf.If the Text property for the associated control is empty, the GetDesignTimeHtml method calls the GetEmptyDesignTimeHtml method. Andernfalls GetDesignTimeHtml erstellt und rendert die-Methode ein Hyperlink-Steuerelement.Otherwise, the GetDesignTimeHtml method creates and renders a Hyperlink control.

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

Hinweise für Vererber

Wenn Sie ein benutzerdefiniertes Container Steuerelement erstellen, stellen Sie sicher, dass Sie das Steuerelement und alle untergeordneten Steuerelemente zur Entwurfszeit Rendering, unabhängig davon, ob die- Visible Eigenschaft auf oder festgelegt ist true false .If you are creating a custom container control, make sure that you render the control and all child controls at design time, regardless of whether the Visible property is set to true or false.

Siehe auch

Gilt für: