This documentation is archived and is not being maintained.

ControlDesigner.SetEditableDesignerRegionContent Method

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 virtual void SetEditableDesignerRegionContent(
	EditableDesignerRegion region,
	string content
)

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. 
public override void SetEditableDesignerRegionContent(EditableDesignerRegion region, string content)
{
    if (content == null)
        return;

    // Get a reference to the designer host
    IDesignerHost host = (IDesignerHost)Component.Site.GetService(typeof(IDesignerHost));
    if (host != null)
    {
        // Create a template from the content string
        ITemplate template = ControlParser.ParseTemplate(host, content);

        // Determine which region should get the template 
        // Either 'Content0' or 'Content1' 
        if (region.Name.EndsWith("0"))
            myControl.View1 = template;
        else if (region.Name.EndsWith("1"))
            myControl.View2 = template;
    }
}

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: