IWebEditable.CreateEditorParts メソッド

public:
 System::Web::UI::WebControls::WebParts::EditorPartCollection ^ CreateEditorParts();

public System.Web.UI.WebControls.WebParts.EditorPartCollection CreateEditorParts();

abstract member CreateEditorParts : unit -> System.Web.UI.WebControls.WebParts.EditorPartCollection

Public Function CreateEditorParts () As EditorPartCollection

戻り値

サーバー コントロールに関連付けられているカスタム EditorPart コントロールのコレクションを含むEditorPartCollection。

例

次のコード例は、カスタム WebPart コントロールのCreateEditorParts メソッドのオーバーライドを示しています。 サンプルを実行するために必要な完全なソース コードについては、 IWebEditable クラスの概要に関するトピックの「例」セクションを参照してください。

このコード例には、 IWebEditable インターフェイスの両方のメンバーが含まれています。 CreateEditorParts メソッドのオーバーライドにより、1 つ以上のカスタム EditorPart コントロールを収集するArrayListが作成され、そのリストを使用してEditorPartCollection オブジェクトが作成されることに注意してください。

public override EditorPartCollection CreateEditorParts()
{
  ArrayList editorArray = new ArrayList();
  TextDisplayEditorPart edPart = new TextDisplayEditorPart();
  edPart.ID = this.ID + "_editorPart1";
  editorArray.Add(edPart);
  EditorPartCollection editorParts = 
    new EditorPartCollection(editorArray);
  return editorParts;
}

public override object WebBrowsableObject
{
  get { return this; }
}

Public Overrides Function CreateEditorParts() _
                            As EditorPartCollection
  Dim editorArray As New ArrayList()
  Dim edPart as New TextDisplayEditorPart()
  edPart.ID = Me.ID & "_editorPart1"
  editorArray.Add(edPart)
  Dim editorParts As New EditorPartCollection(editorArray)
  Return editorParts

End Function

Public Overrides ReadOnly Property WebBrowsableObject() _
                                    As Object
  Get
    Return Me
  End Get
End Property

注釈

CreateEditorParts メソッドを使用すると、カスタム コントロール、WebPart コントロール、またはユーザー コントロールに関連付けられているすべてのカスタム EditorPart コントロールのコレクションを作成し、EditorPartCollection オブジェクトとして返します。 WebPartManager コントロールは、コレクションを取得し、サーバー コントロールが編集モードになったときに常にすべてのEditorPart コントロールのインスタンスを作成します。

通常、このメソッドは、CreateEditorParts メソッドをオーバーライドすることによって、カスタム WebPart コントロールに実装します。 このメソッドでは、コントロールに関連付けるカスタム EditorPart コントロールのインスタンスを作成し、 EditorPartCollection オブジェクトに追加して、そのオブジェクトを返します。 その後、EditorPart コントロールのコレクションが、EditorZoneBase ゾーンのEditorParts プロパティに割り当てられます。

注意 (実装者)

CreateEditorParts() メソッドが返すEditorPartCollection オブジェクトは読み取り専用であり、個々のコントロールを追加するアクセス可能なメソッドはありません。 ただし、メソッドのオーバーライドまたは実装では、ArrayListなどの別の種類のICollection オブジェクトを作成して、すべてのカスタム EditorPart コントロールを格納し、新しいEditorPartCollection オブジェクトを作成するときにコンストラクターに渡すことができます。 コード例については、「例」セクションを参照してください。

こちらもご覧ください

• EditorPart
• ASP.NET Web パーツ コントロール