ControlDesigner.GetEditableDesignerRegionContent Methode

Definition

Gibt den Inhalt für einen bearbeitbaren Bereich der Entwurfszeitansicht des zugeordneten Steuerelements zurück.

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

Parameter

region
EditableDesignerRegion

Das EditableDesignerRegion-Objekt, für das der Inhalt abgerufen werden soll.

Gibt zurück

Der beibehaltene Inhalt für den Bereich, wenn der Steuerelement-Designer bearbeitbare Bereiche unterstützt; andernfalls eine leere Zeichenfolge ("").

Beispiele

Das folgende Codebeispiel zeigt, wie Sie einen Verweis auf den Entwurfshost abrufen und dann den Verweis verwenden, um ein ControlParser Objekt zu erstellen, das das HTML-Markup für region und seinen Inhalt erstellt.

// Get the content string for the selected region. Called by the designer host?
public override string GetEditableDesignerRegionContent(EditableDesignerRegion region) 
{
    // Get a reference to the designer host
    IDesignerHost host = (IDesignerHost)Component.Site.GetService(typeof(IDesignerHost));
    if (host != null)
    {
        ITemplate template = myControl.View1;
        if (region.Name == "Content1")
            template = myControl.View2;

        // Persist the template in the design host
        if (template != null)
            return ControlPersister.PersistTemplate(template, host);
    }

    return String.Empty;
}
' Get the content string for the selected region. Called by the designer host?
Public Overrides Function GetEditableDesignerRegionContent(ByVal region As EditableDesignerRegion) As String
    ' Get a reference to the designer host
    Dim host As IDesignerHost = CType(Component.Site.GetService(GetType(IDesignerHost)), IDesignerHost)

    If Not IsNothing(host) Then
        Dim template As ITemplate = myControl.View1
        If region.Name = "Content1" Then
            template = myControl.View2
        End If

        ' Persist the template in the design host
        If Not IsNothing(template) Then
            Return ControlPersister.PersistTemplate(template, host)
        End If
    End If

    Return String.Empty
End Function

Hinweise

Die Standardimplementierung der GetEditableDesignerRegionContent Methode gibt eine leere Zeichenfolge ("") zurück.

Von der ControlDesigner -Klasse abgeleitete Klassen können die regionsbasierte Bearbeitung auf der Entwurfsoberfläche unterstützen und die GetEditableDesignerRegionContent Methode überschreiben, um den Inhalt für eine angegebene Region zurückzugeben.

Gilt für:

Weitere Informationen