ControlDesigner.GetDesignTimeHtml Methode

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

Parameters

Retouren

De ontwerptijd html-markeringen voor het bijbehorende besturingselement, inclusief alle ontwerpregio's voor besturingselementen.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u HTML-markeringen maakt met behulp van de DesignerRegionCollection verzameling.

// 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

Opmerkingen

De ontwerphost roept de GetDesignTimeHtml methode aan om de HTML-markeringen voor ontwerptijd en de huidige lijst met ontwerpontwerperregio's voor besturingselementen op te halen. Met de DesignerRegionCollection kan de ontwerphost vervolgens de markeringen aanvragen voor elke bewerkbare ontwerpregio.

De GetDesignTimeHtml methode wordt geleverd voor een afgeleide ontwerpfunctie voor besturingselementen, zoals de GridViewDesigner klasse, die de inhoud voor de regio moet verwerken voordat de GetDesignTimeHtml methode wordt aangeroepen.

Zie ook

• GridViewDesigner
• overzicht van ASP.NET Control Designers

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

Retouren

De HTML-opmaak die wordt gebruikt om het besturingselement tijdens het ontwerp aan te geven.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de GetDesignTimeHtml methode kunt overschrijven in een aangepaste ontwerpfunctie voor besturingselementen. Als de eigenschap Text voor het bijbehorende besturingselement leeg is, roept de GetDesignTimeHtml methode de GetEmptyDesignTimeHtml methode aan. Anders wordt met de GetDesignTimeHtml methode een besturingselement Hyperlink gemaakt en weergegeven.

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

Notities voor overnemers

Als u een aangepast containerbesturingselement maakt, moet u ervoor zorgen dat u het besturingselement en alle onderliggende besturingselementen tijdens het ontwerp weergeeft, ongeacht of de Visible eigenschap is ingesteld true op of false.

Zie ook

• GetEmptyDesignTimeHtml()
• GetErrorDesignTimeHtml(Exception)
• GetDesignTimeHtml(DesignerRegionCollection)
• overzicht van ASP.NET Control Designers