ControlDesigner.GetDesignTimeHtml Metod

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

Parametrar

Returer

HTML-kod för designtid för den associerade kontrollen, inklusive alla kontrolldesignerregioner.

Exempel

I följande kodexempel visas hur du skapar HTML-kod med hjälp av DesignerRegionCollection samlingen.

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

Kommentarer

Designvärden anropar GetDesignTimeHtml metoden för att hämta HTML-markering för designtid och den aktuella listan över kontrolldesignerregioner. Med hjälp av DesignerRegionCollection kan designvärden sedan begära markering för varje redigerbar kontrolldesignerregion.

Metoden GetDesignTimeHtml tillhandahålls för en härledd kontrolldesigner, till exempel klassen, som GridViewDesigner måste bearbeta innehållet för regionen innan metoden anropas GetDesignTimeHtml .

Se även

• GridViewDesigner
• översikt över 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

Returer

HTML-markering som används för att representera kontrollen vid designtillfället.

Exempel

I följande kodexempel visas hur du åsidosätter GetDesignTimeHtml metoden i en anpassad kontrolldesigner. Om egenskapen Text för den associerade kontrollen är tom GetDesignTimeHtml anropar GetEmptyDesignTimeHtml metoden metoden. I annat fall GetDesignTimeHtml skapar och återger metoden en hyperlänkkontroll.

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

Anteckningar till arvingar

Om du skapar en anpassad containerkontroll kontrollerar du att du återger kontrollen och alla underordnade kontroller vid designtillfället, oavsett om Visible egenskapen är inställd true på eller false.

Se även

• GetEmptyDesignTimeHtml()
• GetErrorDesignTimeHtml(Exception)
• GetDesignTimeHtml(DesignerRegionCollection)
• översikt över ASP.NET Control Designers