ControlDesigner.GetDesignTimeHtml Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI.Design
Assembly:
System.Design.dll

Récupère le balisage HTML utilisé pour représenter le contrôle au moment du design.

Surcharges

GetDesignTimeHtml(DesignerRegionCollection)

Récupère le balisage HTML pour afficher le contrôle et remplit la collection avec les zones du Concepteur de contrôles actuelles.
GetDesignTimeHtml()

Récupère le balisage HTML utilisé pour représenter le contrôle au moment du design.

GetDesignTimeHtml(DesignerRegionCollection)

Récupère le balisage HTML pour afficher le contrôle et remplit la collection avec les zones du Concepteur de contrôles actuelles.

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

Paramètres

regions
DesignerRegionCollection

Collection de zones du Concepteur de contrôles pour le contrôle associé.

Retours

String

Balisage HTML au moment du design pour le contrôle associé, notamment toutes les zones du Concepteur de contrôles.

Exemples

L’exemple de code suivant montre comment créer un balisage HTML à l’aide de la 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

Remarques

L’hôte de conception appelle la GetDesignTimeHtml méthode pour obtenir le balisage HTML au moment du design et la liste actuelle des régions du concepteur de contrôles. À l’aide de DesignerRegionCollection, l’hôte de conception peut ensuite demander le balisage pour chaque région du concepteur de contrôles modifiable.

La GetDesignTimeHtml méthode est fournie pour un concepteur de contrôles dérivé, tel que la GridViewDesigner classe, qui doit traiter le contenu de la région avant d’appeler la GetDesignTimeHtml méthode.

Voir aussi

S’applique à

GetDesignTimeHtml()

Récupère le balisage HTML utilisé pour représenter le contrôle au moment du design.

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

Retours

String

Balisage HTML utilisé pour représenter le contrôle au moment du design.

Exemples

L’exemple de code suivant montre comment remplacer la GetDesignTimeHtml méthode dans un concepteur de contrôles personnalisé. Si la propriété Text du contrôle associé est vide, la GetDesignTimeHtml méthode appelle la GetEmptyDesignTimeHtml méthode. Sinon, la GetDesignTimeHtml méthode crée et affiche un contrôle Hyperlink.

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

Notes pour les héritiers

Si vous créez un contrôle de conteneur personnalisé, assurez-vous d’afficher le contrôle et tous les contrôles enfants au moment de la conception, que la Visible propriété soit définie true ou falsenon.

Voir aussi

S’applique à