Share via

EditorZoneBase.EditorParts Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Získá kolekci všech EditorPart ovládacích prvků obsažených v EditorZoneBase zóně.

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

Hodnota vlastnosti

EditorPartCollection

Obsahuje EditorPartCollection všechny jednotlivé EditorPart ovládací prvky v zóně.

Atributy
BrowsableAttribute

Výjimky

InvalidOperationException

Přidání EditorPart do kolekce nemá přiřazenou hodnotu vlastnosti ID.

Příklady

Následující příklad kódu ukazuje, jak přistupovat k EditorParts vlastnosti programově. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad tématu přehledu EditorZoneBase třídy.

První část příkladu kódu ukazuje, že EditorParts vlastnost obsahuje odkazy na všechny EditorPart ovládací prvky, které jsou odkazovány deklarativní na webové stránce.

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

Druhá část příkladu kódu programově přistupuje k EditorParts vlastnosti a vypíše ID každého ovládacího prvku v ovládacím Label prvku.

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

Když načtete stránku v prohlížeči, můžete kliknout na tlačítko Zobrazit EditorParts Collection zobrazit seznam ID všech EditorPart ovládacích prvků odkazovaných ve EditorParts vlastnosti.

Poznámky

Vlastnost EditorParts poskytuje odkaz na kolekci všech EditorPart ovládacích prvků v zóně. Odkazuje na EditorPart ovládací prvky poskytnuté v sadě ovládacích prvků Webové části i na všechny vlastní EditorPart ovládací prvky přidané do zóny. Protože je kolekce jen pro čtení, vývojáři, kteří chtějí vytvořit vlastní EditorPart ovládací prvky pro obecné účely úprav a přidat je do kolekce, by měli metodu CreateEditorParts přepsat.

Pokud navrhujete vlastní EditorPart ovládací prvky pro úpravu určitého WebPart ovládacího prvku, měli byste přepsat členy IWebEditable rozhraní – metodu CreateEditorParts WebBrowsableObject a vlastnost - v ovládacím WebPart prvku. Důvodem přepsání těchto členů je umožnit ovládacímu WebPart prvku vytvořit vlastní EditorPart ovládací prvky a přidat je do EditorParts kolekce při úpravách ovládacího prvku a poskytnout ovládacím prvkům pro úpravy objektu odkaz na WebPart ovládací prvek, který upravuje. Pokud chcete přidat vlastní EditorPart ovládací prvek pro úpravu serverového ovládacího prvku, který nedědí z WebPart třídy, musíte implementovat IWebEditable rozhraní ve třídě stejně jako pro WebPart ovládací prvek.

Poznámka

Všimněte si, že všechny EditorPart přidané do kolekce ovládacích EditorPart prvků v implementaci CreateEditorParts metody musí mít přiřazenou hodnotu k jeho ID vlastnost, jinak se vyvolá výjimka, když je kolekce přiřazena EditorParts k vlastnosti.

Platí pro

Viz také