ControlDesigner.SetEditableDesignerRegionContent メソッド

.NET Framework クラス ライブラリ リファレンス

ControlDesigner.SetEditableDesignerRegionContent メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

デザイン時にコントロールの編集可能領域の内容を指定します。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As ControlDesigner
Dim region As EditableDesignerRegion
Dim content As String

instance.SetEditableDesignerRegionContent(region, content)

C#

public virtual void SetEditableDesignerRegionContent
 (
    EditableDesignerRegion region,
    string content
)

C++

public:
virtual void SetEditableDesignerRegionContent (
    EditableDesignerRegion^ region, 
    String^ content
)

J#

public void SetEditableDesignerRegionContent
 (
    EditableDesignerRegion region, 
    String content
)

JScript

public function SetEditableDesignerRegionContent
 (
    region : EditableDesignerRegion, 
    content : String
)

パラメータ

region

コントロールに含まれる編集可能なデザイン領域。

content

編集可能なデザイン領域に割り当てる内容。

解説

ControlDesigner クラスから派生したクラスでは、デザイン サーフェイスでの領域ベースの編集をサポートでき、SetEditableDesignerRegionContent をオーバーライドして指定した領域の内容を設定できます。

使用例

デザイン ホストへの参照を取得し、その参照を使用して、content を ITemplate インターフェイスのインスタンスに変更し、ITemplate を適切なビューに割り当てる ControlParser オブジェクトを作成する方法のコード例を次に示します。

Visual Basic

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

        If Not IsNothing(template) Then

            ' 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 If
End Sub

C#

// 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;
        }
    }
}

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Web.UI.Design 名前空間
GetEditableDesignerRegionContent
EditableDesignerRegion
その他の技術情報
Web フォームのデザイン時サポート