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
)
public void SetEditableDesignerRegionContent (
	EditableDesignerRegion region, 
	String content
)
public function SetEditableDesignerRegionContent (
	region : EditableDesignerRegion, 
	content : String
)
Not applicable.

Parameters

region

An editable design region contained within the control.

content

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);

        if (template != null)
        {
            // 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 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Show: