EditorZoneBase.EditorParts Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft eine Auflistung aller EditorPart-Steuerelemente auf, die in einer EditorZoneBase-Zone enthalten sind.

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

Eigenschaftswert

EditorPartCollection

Eine EditorPartCollection, die alle einzelnen EditorPart-Steuerelemente in einer Zone enthält.

Attribute: BrowsableAttribute

Ausnahmen

InvalidOperationException

Bei einem EditorPart, das der Auflistung hinzugefügt wird, ist der ID-Eigenschaft kein Wert zugewiesen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie programmgesteuert auf die EditorParts Eigenschaft zugreifen. Den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt Beispiel des EditorZoneBase Themas Klassenübersicht.

Im ersten Teil des Codebeispiels wird veranschaulicht, dass die EditorParts -Eigenschaft Verweise auf alle Steuerelemente enthält, auf EditorPart die deklarativ auf der Webseite verwiesen wird.

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

Der zweite Teil des Codebeispiels greift programmgesteuert auf die EditorParts Eigenschaft zu und listet die ID jedes Steuerelements in einem Steuerelement auf 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

Wenn Sie die Seite in einem Browser laden, können Sie auf die Schaltfläche Display EditorParts Collection klicken, um die IDs aller Steuerelemente aufzulisten, auf die EditorPart in der EditorParts -Eigenschaft verwiesen wird.

Hinweise

Die EditorParts -Eigenschaft stellt einen Verweis auf eine Auflistung aller EditorPart Steuerelemente in der Zone bereit. Sie verweist sowohl auf die EditorPart Steuerelemente, die mit dem Webpart-Steuerelementsatz bereitgestellt werden, als auch auf alle benutzerdefinierten EditorPart Steuerelemente, die der Zone hinzugefügt werden. Da die Auflistung schreibgeschützt ist, sollten Entwickler, die benutzerdefinierte EditorPart Steuerelemente für allgemeine Bearbeitungszwecke erstellen und der Auflistung hinzufügen möchten, die CreateEditorParts Methode überschreiben.

Wenn Sie benutzerdefinierte EditorPart Steuerelemente entwerfen, um ein bestimmtes WebPart Steuerelement zu bearbeiten, sollten Sie die Member der IWebEditable Schnittstelle - die --Methode CreateEditorParts und die WebBrowsableObject -Eigenschaft - im WebPart -Steuerelement überschreiben. Der Grund, diese Member zu überschreiben, besteht darin, das WebPart Steuerelement zu aktivieren, die benutzerdefinierten EditorPart Steuerelemente zu erstellen und sie der EditorParts Auflistung hinzuzufügen, wenn das Steuerelement bearbeitet wird, und die Bearbeitungssteuerelemente mit einem Objektverweis auf das Steuerelement bereitzustellen, das WebPart sie bearbeiten. Wenn Sie ein benutzerdefiniertes EditorPart Steuerelement hinzufügen möchten, um ein Serversteuerelement zu bearbeiten, das nicht von der WebPart -Klasse erbt, müssen Sie die IWebEditable Schnittstelle in der -Klasse genau wie für ein WebPart Steuerelement implementieren.

Hinweis

Beachten Sie, dass alle EditorPart , die der Auflistung von EditorPart Steuerelementen in einer Implementierung der CreateEditorParts -Methode hinzugefügt werden, der ID-Eigenschaft einen Wert zugewiesen haben müssen. Andernfalls wird eine Ausnahme ausgelöst, wenn die Auflistung der EditorParts -Eigenschaft zugewiesen wird.

Gilt für:

Freigeben über