ControlDesigner.GetEditableDesignerRegionContent Methode

Definition

Namespace:
System.Web.UI.Design
Assembly:
System.Design.dll

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 Inhalt abgerufen werden soll.

Gibt zurück

String

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

Beispiele

Das folgende Codebeispiel zeigt, wie Sie einen Verweis auf den Designhost abrufen und dann den Verweis verwenden, um ein ControlParser Objekt zu erstellen, das das HTML-Markup für region und deren 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.

Klassen, die von der ControlDesigner Klasse abgeleitet werden, können die regionsbasierte Bearbeitung auf der Entwurfsoberfläche unterstützen und die GetEditableDesignerRegionContent Methode überschreiben, um den Inhalt für einen bestimmten Bereich zurückzugeben.

Gilt für:

Weitere Informationen