ControlDesigner.GetDesignTimeHtml Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.Design
Assembly:
System.Design.dll

Recupera il markup HTML usato per rappresentare il controllo in fase di progettazione.

Overload

GetDesignTimeHtml(DesignerRegionCollection)

Recupera il markup HTML per la visualizzazione del controllo e popola la raccolta con le aree della finestra di progettazione controlli correnti.
GetDesignTimeHtml()

Recupera il markup HTML usato per rappresentare il controllo in fase di progettazione.

GetDesignTimeHtml(DesignerRegionCollection)

Recupera il markup HTML per la visualizzazione del controllo e popola la raccolta con le aree della finestra di progettazione controlli correnti.

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

Parametri

regions
DesignerRegionCollection

Raccolta di aree della finestra di progettazione controlli per il controllo associato.

Restituisce

String

Markup HTML della fase di progettazione per il controllo associato, comprese tutte le aree della finestra di progettazione controlli.

Esempio

Nell'esempio di codice seguente viene illustrato come creare markup HTML usando la DesignerRegionCollection raccolta.

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

Commenti

L'host di progettazione chiama il metodo per ottenere il GetDesignTimeHtml markup HTML in fase di progettazione e l'elenco corrente delle aree della finestra di progettazione controlli. Usando DesignerRegionCollection, l'host di progettazione può quindi richiedere il markup per ogni area di progettazione controlli modificabile.

Il GetDesignTimeHtml metodo viene fornito per una finestra di progettazione di controlli derivata, ad esempio la GridViewDesigner classe, che deve elaborare il contenuto per l'area prima di chiamare il GetDesignTimeHtml metodo.

Vedi anche

Si applica a

GetDesignTimeHtml()

Recupera il markup HTML usato per rappresentare il controllo in fase di progettazione.

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

Restituisce

String

Markup HTML usato per rappresentare il controllo in fase di progettazione.

Esempio

Nell'esempio di codice seguente viene illustrato come eseguire l'override del GetDesignTimeHtml metodo in una finestra di progettazione di controlli personalizzata. Se la proprietà Text per il controllo associato è vuota, il GetDesignTimeHtml metodo chiama il GetEmptyDesignTimeHtml metodo . In caso contrario, il metodo crea e esegue il GetDesignTimeHtml rendering di un controllo Collegamento ipertestuale.

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

Note per gli eredi

Se si crea un controllo contenitore personalizzato, assicurarsi di eseguire il rendering del controllo e di tutti i controlli figlio in fase di progettazione, indipendentemente dal fatto che la Visible proprietà sia impostata su true o false.

Vedi anche

Si applica a