EditorZoneBase.EditorParts Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera kolekcję wszystkich EditorPart kontrolek zawartych w EditorZoneBase strefie.

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

Wartość właściwości

EditorPartCollection

Element EditorPartCollection zawierający wszystkie poszczególne EditorPart kontrolki w strefie.

Atrybuty: BrowsableAttribute

Wyjątki

InvalidOperationException

Element EditorPart dodawany do kolekcji nie ma wartości przypisanej do jej właściwości ID.

Przykłady

W poniższym przykładzie kodu pokazano, jak programowo uzyskać dostęp do EditorParts właściwości. Pełny kod wymagany do uruchomienia przykładu można znaleźć w sekcji Przykład w EditorZoneBase temacie Omówienie klasy.

Pierwsza część przykładu kodu pokazuje, że EditorParts właściwość zawiera odwołania do wszystkich EditorPart kontrolek, do których odwołuje się deklaratywnie na stronie sieci Web.

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

Druga część przykładu kodu programowo uzyskuje dostęp do EditorParts właściwości i wyświetla identyfikator każdej kontrolki w kontrolce 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

Po załadowaniu strony w przeglądarce możesz kliknąć przycisk Wyświetl edytorParts Collection , aby wyświetlić listę identyfikatorów wszystkich EditorPart kontrolek, do których odwołuje się EditorParts właściwość .

Uwagi

Właściwość EditorParts zawiera odwołanie do kolekcji wszystkich EditorPart kontrolek w strefie. Odwołuje się zarówno do EditorPart kontrolek dostarczanych z zestawem kontrolek składników Web Part, jak i do wszystkich kontrolek niestandardowych EditorPart , które są dodawane do strefy. Ponieważ kolekcja jest tylko do odczytu, deweloperzy, którzy chcą tworzyć kontrolki niestandardowe EditorPart do ogólnych celów edycji i dodawać je do kolekcji, powinni zastąpić metodę CreateEditorParts .

W przypadku projektowania kontrolek niestandardowych EditorPart w celu edytowania określonej WebPart kontrolki należy zastąpić elementy członkowskie IWebEditable interfejsu — CreateEditorParts metody i WebBrowsableObject właściwości — w kontrolce WebPart . Powodem zastąpienia tych elementów członkowskich jest umożliwienie kontrolki WebPart tworzenia kontrolek niestandardowych EditorPart i dodawania ich do EditorParts kolekcji podczas edycji kontrolki oraz udostępniania kontrolek edycji przy użyciu odwołania do obiektu do WebPart kontrolki, którą edytują. Jeśli chcesz dodać kontrolkę niestandardową EditorPart , aby edytować kontrolkę serwera, która nie dziedziczy z WebPart klasy, musisz zaimplementować IWebEditable interfejs w klasie tak samo jak w przypadku kontrolki WebPart .

Uwaga

Należy pamiętać, że wszystkie elementy EditorPart dodane do kolekcji EditorPart kontrolek w implementacji CreateEditorParts metody muszą mieć wartość przypisaną do jej właściwości ID. W przeciwnym razie wyjątek zostanie zgłoszony, gdy kolekcja zostanie przypisana EditorParts do właściwości .

Dotyczy

Udostępnij przez