EditorZoneBase.EditorParts Eigenschaft

  • Referenz

Definition

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

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. Für den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt "Beispiel" des EditorZoneBase Klassenübersichtsthemas.

Im ersten Teil des Codebeispiels wird veranschaulicht, dass die EditorParts Eigenschaft Verweise auf alle EditorPart Steuerelemente enthält, auf die deklarativ auf die 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 Label Steuerelement auf.

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 "EditorParts-Auflistung anzeigen" klicken, um die IDs aller EditorPart Steuerelemente auflisten zu können, auf die in der EditorParts Eigenschaft verwiesen wird.

Hinweise

Die EditorParts Eigenschaft stellt einen Verweis auf eine Auflistung aller EditorPart Steuerelemente in der Zone bereit. Es verweist sowohl auf die Steuerelemente, die mit dem Webparts Steuerelementsatz bereitgestellt werden, als auch auf alle benutzerdefinierten EditorPart Steuerelemente, die EditorPart 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 außer Kraft setzen.

Wenn Sie benutzerdefinierte EditorPart Steuerelemente zum Bearbeiten eines bestimmten WebPart Steuerelements entwerfen, sollten Sie die Elemente der IWebEditable Schnittstelle CreateEditorParts und der WebBrowsableObject Eigenschaft WebPart im Steuerelement außer Kraft setzen. Der Grund zum Außerkraftsetzen dieser Elemente besteht darin, das WebPart Steuerelement zu aktivieren, um die benutzerdefinierten EditorPart Steuerelemente zu erstellen und sie der Auflistung hinzuzufügen, wenn Ihr Steuerelement bearbeitet wird, und EditorParts die Bearbeitungssteuerelemente mit einem Objektverweis auf das WebPart Steuerelement bereitzustellen, das sie bearbeiten. Wenn Sie ein benutzerdefiniertes EditorPart Steuerelement hinzufügen möchten, um ein Serversteuerelement zu bearbeiten, das nicht von der Klasse erbt, müssen Sie die IWebEditable Schnittstelle in der WebPart Klasse wie für ein WebPart Steuerelement implementieren.

Hinweis

Beachten Sie, dass jeder EditorPart , der der Auflistung von EditorPart Steuerelementen in einer Implementierung der CreateEditorParts Methode hinzugefügt wird, einen Wert aufweisen muss, der seiner ID-Eigenschaft zugewiesen ist, andernfalls wird eine Ausnahme ausgelöst, wenn die Auflistung der EditorParts Eigenschaft zugewiesen wird.

Gilt für

Siehe auch