ControlDesigner.SetEditableDesignerRegionContent Method (EditableDesignerRegion, String)

 

Specifies the content for an editable region of the control at design time.

Namespace:   System.Web.UI.Design
Assembly:  System.Design (in System.Design.dll)

Public Overridable Sub SetEditableDesignerRegionContent (
	region As EditableDesignerRegion,
	content As String
)

Parameters

region
Type: System.Web.UI.Design.EditableDesignerRegion

An editable design region contained within the control.

content
Type: System.String

The content to assign for the editable design region.

Classes deriving from the ControlDesigner class can support region-based editing on the design surface and override the SetEditableDesignerRegionContent method to set the content for a specified region.

The following code example shows how to get a reference to the design host, and then use the reference to create a ControlParser object that turns content into an instance of the ITemplate interface and assigns the ITemplate instance to the appropriate view.

' Create a template from the content string and put it 
' in the selected view. Called by the designer host?
Public Overrides Sub SetEditableDesignerRegionContent(ByVal region As EditableDesignerRegion, ByVal content As String)
    If IsNothing(content) Then
        Return
    End If

    ' Get a reference to the designer host
    Dim host As IDesignerHost = CType(Component.Site.GetService(GetType(IDesignerHost)), IDesignerHost)
    If Not IsNothing(host) Then
        ' Create a template from the content string
        Dim template As ITemplate = ControlParser.ParseTemplate(host, content)

        ' Determine which region should get the template
        If region.Name.EndsWith("0") Then
            myControl.View1 = template
        ElseIf region.Name.EndsWith("1") Then
            myControl.View2 = template
        End If

    End If
End Sub

.NET Framework
Available since 2.0
Return to top
Show: