EditorZoneBase.EditorParts プロパティ

定義

名前空間:

System.Web.UI.WebControls.WebParts

アセンブリ:

System.Web.dll

EditorPart ゾーンに含まれるすべての EditorZoneBase コントロールのコレクションを取得します。

public:
 property System::Web::UI::WebControls::WebParts::EditorPartCollection ^ EditorParts { System::Web::UI::WebControls::WebParts::EditorPartCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.EditorPartCollection EditorParts { get; }

[<System.ComponentModel.Browsable(false)>]
member this.EditorParts : System.Web.UI.WebControls.WebParts.EditorPartCollection

Public ReadOnly Property EditorParts As EditorPartCollection

プロパティ値

EditorPartCollection

ゾーン内の個別の EditorPartCollection コントロールすべてを含む EditorPart。

属性

BrowsableAttribute

例外

InvalidOperationException

コレクションに追加される EditorPart の ID プロパティに値が割り当てられていません。

例

次のコード例は、 プロパティにプログラムでアクセスする方法を EditorParts 示しています。 この例を実行するために必要な完全なコードについては、クラスの概要に関するトピックの「例」セクションを EditorZoneBase 参照してください。

コード例の最初の部分では、 プロパティに EditorParts 、Web ページで宣言的に参照されるすべての EditorPart コントロールへの参照が含まれていることを示します。

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

コード例の 2 番目の部分では、プログラムによって プロパティにアクセス EditorParts し、コントロール内 Label の各コントロールの ID を一覧表示します。

void Button3_Click(object sender, EventArgs e)
{
  Label1.Text = "<br />";
  foreach (EditorPart part in EditorZone1.EditorParts)
  {
    Label1.Text += part.ID + "<br />";
  }
}

Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = "<br />"
  Dim part As EditorPart
  For Each part In EditorZone1.EditorParts
    Label1.Text += part.ID + "<br />"
  Next part
End Sub

ブラウザーでページを読み込むときは、[エディター][パーツ コレクションの表示] ボタンをクリックして、 プロパティでEditorParts参照されているすべてのEditorPartコントロールの ID を一覧表示できます。

注釈

プロパティは EditorParts 、ゾーン内のすべての EditorPart コントロールのコレクションへの参照を提供します。 Web パーツ コントロール セットで EditorPart 提供されるコントロールと、ゾーンに追加されるカスタム EditorPart コントロールの両方を参照します。 コレクションは読み取り専用であるため、一般的な編集目的でカスタム EditorPart コントロールを作成し、コレクションに追加する開発者は、 メソッドを CreateEditorParts オーバーライドする必要があります。

特定WebPartのコントロールを編集するようにカスタム EditorPart コントロールを設計する場合は、interface-the CreateEditorParts メソッドのメンバーIWebEditableとWebBrowsableObjectコントロールのプロパティをオーバーライドするWebPart必要があります。 これらのメンバーをオーバーライドする理由は、コントロールがカスタム コントロールをWebPart作成し、コントロールの編集時にEditorPartsコレクションに追加し、編集中のコントロールへのオブジェクト参照を編集コントロールにWebPart提供できるようにするためEditorPartです。 クラスからWebPart継承されないサーバー コントロールを編集するカスタム EditorPart コントロールを追加する場合は、コントロールの場合と同様に、 クラスに インターフェイスをWebPart実装IWebEditableする必要があります。

注意

メソッドの実装CreateEditorPartsでコントロールのEditorPartコレクションに追加されるはEditorPart、その ID プロパティに値が割り当てられている必要があることに注意してください。それ以外の場合は、コレクションが プロパティにEditorParts割り当てられると例外がスローされます。

こちらもご覧ください

• IWebEditable
• CreateEditorParts()
• CreateEditorParts()
• ASP.NET Web パーツ コントロール