ControlDesigner.GetEditableDesignerRegionContent メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ControlDesigner.GetEditableDesignerRegionContent メソッド

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

関連付けられたコントロールのデザイン時ビューの編集可能領域の内容を返します。

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

Visual Basic (宣言)

Public Overridable Function
 GetEditableDesignerRegionContent ( _
    region As EditableDesignerRegion _
) As String

Visual Basic (使用法)

Dim instance As ControlDesigner
Dim region As EditableDesignerRegion
Dim returnValue As String

returnValue = instance.GetEditableDesignerRegionContent(region)

public virtual string GetEditableDesignerRegionContent
 (
    EditableDesignerRegion region
)

C++

public:
virtual String^ GetEditableDesignerRegionContent (
    EditableDesignerRegion^ region
)

public String GetEditableDesignerRegionContent (
    EditableDesignerRegion region
)

JScript

public function GetEditableDesignerRegionContent
 (
    region : EditableDesignerRegion
) : String

パラメータ

region: 内容の取得対象の EditableDesignerRegion。

戻り値
編集可能な領域をコントロールデザイナがサポートする場合は領域の永続化された内容。それ以外の場合は空の文字列 ("")。

解説

GetEditableDesignerRegionContent メソッドの既定の実装では、空の文字列 ("") が返されます。

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

使用例

デザインホストへの参照を取得し、その参照を使用して、region およびその内容の HTML マークアップを作成する ControlParser オブジェクトを作成する方法のコード例を次に示します。

Visual Basic

' 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

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