EditorZoneBase.EditorParts Vlastnost

Reference

Definice

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

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá kolekci EditorPart všech 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

Objekt EditorPartCollection , který obsahuje všechny jednotlivé EditorPart ovládací prvky v zóně.

Atributy: BrowsableAttribute

Výjimky

InvalidOperationException

Objekt EditorPart přidaný do kolekce nemá přiřazenou hodnotu ke své vlastnosti ID.

Příklady

Následující příklad kódu ukazuje, jak získat přístup EditorParts k vlastnosti programově. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad v 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, na 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 prvku Label .

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

Při načtení stránky v prohlížeči můžete kliknutím na tlačítko Zobrazit editorSoučásti kolekce zobrazit seznam ID všech EditorPart ovládacích prvků, na které se EditorParts ve vlastnosti odkazuje.

Poznámky

Vlastnost EditorParts poskytuje odkaz na kolekci všech ovládacích EditorPart prvků v zóně. Odkazuje jak na EditorPart ovládací prvky poskytnuté se sadou ovládacích prvků webových částí, tak na všechny vlastní EditorPart ovládací prvky, které jsou přidány do zóny. Vzhledem k tomu, že kolekce je 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 k 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 odkaz na objekt na WebPart ovládací prvek, který upravují. 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 u WebPart ovládacího prvku.

Poznámka

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

Platí pro

Sdílet prostřednictvím