EditorPartCollection Konstruktoren

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.

Initialisiert eine neue Instanz der EditorPartCollection-Klasse.

Überlädt

EditorPartCollection()	Initialisiert eine neue, leere Instanz der EditorPartCollection-Klasse.
EditorPartCollection(ICollection)	Initialisiert eine neue Instanz der EditorPartCollection-Klasse, indem eine ICollection-Auflistung von EditorPart-Steuerelementen übergeben wird.
EditorPartCollection(EditorPartCollection, ICollection)	Initialisiert eine neue Instanz der EditorPartCollection-Klasse, indem eine EditorPartCollection-Auflistung von EditorPart-Steuerelementen und eine ICollection-Auflistung von zusätzlichen EditorPart-Steuerelementen übergeben wird.

EditorPartCollection()

Initialisiert eine neue, leere Instanz der EditorPartCollection-Klasse.

public:
 EditorPartCollection();

public EditorPartCollection ();

Public Sub New ()

Hinweise

Der EditorPartCollection Konstruktor initialisiert eine leere Instanz der EditorPartCollection Klasse. Diese Überladung des Konstruktors wird intern von der EditorZone Klasse in seiner CreateEditorParts Methode verwendet, um ein leeres Auflistungsobjekt zu erstellen. Die Zone erstellt dann Instanzen aller Steuerelemente, die EditorPart in der untergeordneten Zone-Vorlage deklariert sind, und verwendet eine interne Methode, um sie der Auflistung hinzuzufügen.

Sie können diese Überladung des EditorPartCollection Konstruktors nicht verwenden, um eine neue Instanz zu EditorPartCollection erstellen und Steuerelemente hinzuzufügen EditorPart . Stattdessen müssen Sie eine der anderen Überladungen für den EditorPartCollection Konstruktor verwenden.

Siehe auch

ASP.NET Webparts Steuerelemente

Gilt für:

EditorPartCollection(ICollection)

Initialisiert eine neue Instanz der EditorPartCollection-Klasse, indem eine ICollection-Auflistung von EditorPart-Steuerelementen übergeben wird.

public:
 EditorPartCollection(System::Collections::ICollection ^ editorParts);

public EditorPartCollection (System.Collections.ICollection editorParts);

new System.Web.UI.WebControls.WebParts.EditorPartCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.EditorPartCollection

Public Sub New (editorParts As ICollection)

Parameter

editorParts: ICollection

Eine ICollection von EditorPart-Steuerelementen.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine benutzerdefinierte EditorPartCollection Und auch wenn die Auflistung schreibgeschützt ist, weiterhin einen Batchvorgang ausführen, um die einzelnen EditorPart Steuerelemente in der Auflistung zu ändern. Für den vollständigen Code, der zum Ausführen des Beispiels erforderlich ist, finden Sie im Abschnitt "Beispiel" der EditorPartCollection Klassenübersicht.

Der Code im Button1_Click Ereignis erstellt ein Objekt, fügt zwei der drei EditorPart Steuerelemente auf der Seite zum Objekt hinzu, und erstellt dann ein ArrayList neues EditorPartCollection Objekt mithilfe des EditorPartCollection Konstruktors. Außerdem wird veranschaulicht, wie Sie Änderungen an den zugrunde liegenden EditorPart Steuerelementen vornehmen können, auch wenn die Auflistung schreibgeschützt ist.

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  protected void Button1_Click(object sender, EventArgs e)
  {
    ArrayList list = new ArrayList(2);
    list.Add(AppearanceEditorPart1);
    list.Add(PropertyGridEditorPart1);
    // Pass an ICollection object to the constructor.
    EditorPartCollection myParts = new EditorPartCollection(list);
    foreach (EditorPart editor in myParts)
    {
      editor.BackColor = System.Drawing.Color.LightBlue;
      editor.Description = "My " + editor.DisplayTitle + " editor.";
    }

    // Use the IndexOf property to locate an EditorPart control.
    int propertyGridPart = myParts.IndexOf(PropertyGridEditorPart1);
    myParts[propertyGridPart].ChromeType = PartChromeType.TitleOnly;

    // Use the Contains method to see if an EditorPart exists.
    if(!myParts.Contains(LayoutEditorPart1))
      LayoutEditorPart1.BackColor = System.Drawing.Color.LightYellow;
    
    // Use the CopyTo method to create an array of EditorParts.
    EditorPart[] partArray = new EditorPart[3];
    partArray[0] = LayoutEditorPart1;
    myParts.CopyTo(partArray,1);
    Label1.Text = "<h3>EditorParts in Custom Array</h3>";
    foreach (EditorPart ePart in partArray)
    {
      Label1.Text += ePart.Title + "<br />";
    }

  }

</script>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim list As New ArrayList(2)
    list.Add(AppearanceEditorPart1)
    list.Add(PropertyGridEditorPart1)
    ' Pass an ICollection object to the constructor.
    Dim myParts As New EditorPartCollection(list)
    Dim editor As EditorPart
    For Each editor In myParts
      editor.BackColor = System.Drawing.Color.LightBlue
      editor.Description = "My " + editor.DisplayTitle + " editor."
    Next editor
    
    ' Use the IndexOf property to locate an EditorPart control.
    Dim propertyGridPart As Integer = _
      myParts.IndexOf(PropertyGridEditorPart1)
    myParts(propertyGridPart).ChromeType = PartChromeType.TitleOnly
    
    ' Use the Contains method to see if an EditorPart exists.
    If Not myParts.Contains(LayoutEditorPart1) Then
      LayoutEditorPart1.BackColor = System.Drawing.Color.LightYellow
    End If
    
    ' Use the CopyTo method to create an array of EditorParts.
    Dim partArray(2) As EditorPart
    partArray(0) = LayoutEditorPart1
    myParts.CopyTo(partArray, 1)
    Label1.Text = "<h3>EditorParts in Custom Array</h3>"
    Dim ePart As EditorPart
    For Each ePart In partArray
      Label1.Text += ePart.Title + "<br />"
    Next ePart

  End Sub

</script>

Sie können die Seite in einem Browser laden und die Seite im Bearbeitungsmodus wechseln, indem Sie im Dropdown-Listensteuerelement "Anzeigemodus bearbeiten" auswählen. Sie können im Titelleiste des TextDisplayWebPart Steuerelements auf das Menü "Verben" (nach unten) klicken, und klicken Sie auf "Bearbeiten ", um das Steuerelement zu bearbeiten. Wenn die Bearbeitungsschnittstelle (Benutzeroberfläche) sichtbar ist, können Sie alle EditorPart Steuerelemente anzeigen. Klicken Sie auf die Schaltfläche "EditorPartCollection erstellen ", um die Auswirkungen auf die beiden EditorPart Steuerelemente anzuzeigen, die dem EditorPartCollection Objekt hinzugefügt werden.

Hinweise

Der EditorPartCollection Konstruktor initialisiert eine Instanz der EditorPartCollection Klasse und übergibt eine Auflistung von EditorPart Steuerelementen. Dies ist eine Überladung des Konstruktors, mit dem EditorPartCollection Sie ein neues EditorPartCollection Objekt erstellen und Steuerelemente hinzufügen EditorPart können.

Obwohl die EditorPartCollection von dem Konstruktor erstellte Instanz schreibgeschützt ist, können Sie weiterhin auf die einzelnen EditorPart Steuerelemente in der Auflistung programmgesteuert zugreifen und ihre Eigenschaften und Methoden aufrufen.

Ein gängiges Szenario für die Verwendung des EditorPartCollection Konstruktors wäre, wenn Sie einige Batchvorgänge für einen gesamten Satz von EditorPart Steuerelementen ausführen möchten, z. B. das Ändern des Inhalts, der Darstellung oder der Position einer verwandten Gruppe dieser Steuerelemente.

Ein anderes häufiges Szenario für die Verwendung des EditorPartCollection Konstruktors ist die Entwicklung benutzerdefinierter Steuerelemente, die Sie einem Serversteuerelement zuordnen möchten, sodass Benutzer benutzerdefinierte EditorPart Eigenschaften auf Ihrem Steuerelement bearbeiten können. In diesem Szenario muss das Serversteuerelement die IWebEditable Schnittstelle implementieren und im Rahmen dieser Aufgabe die Methode implementieren CreateEditorParts . Um die benutzerdefinierten EditorPart Steuerelemente zum Bearbeiten Ihres Serversteuerelements zu aktivieren, müssen EditorPart Sie die Steuerelemente zu einer Instanz hinzufügen, z. B. ein ICollection ArrayList Objekt. Anschließend können Sie die Auflistung von EditorPart Steuerelementen an den Konstruktor übergeben, um ein neues EditorPartCollection Objekt zu erstellen, mit dem EditorPartCollection die EditorZoneBase Zone alle Steuerelemente eingerichtet und den Bearbeitungsprozess beginnt.

Siehe auch

Gilt für:

EditorPartCollection(EditorPartCollection, ICollection)

Initialisiert eine neue Instanz der EditorPartCollection-Klasse, indem eine EditorPartCollection-Auflistung von EditorPart-Steuerelementen und eine ICollection-Auflistung von zusätzlichen EditorPart-Steuerelementen übergeben wird.

public:
 EditorPartCollection(System::Web::UI::WebControls::WebParts::EditorPartCollection ^ existingEditorParts, System::Collections::ICollection ^ editorParts);

public EditorPartCollection (System.Web.UI.WebControls.WebParts.EditorPartCollection existingEditorParts, System.Collections.ICollection editorParts);

new System.Web.UI.WebControls.WebParts.EditorPartCollection : System.Web.UI.WebControls.WebParts.EditorPartCollection * System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.EditorPartCollection

Public Sub New (existingEditorParts As EditorPartCollection, editorParts As ICollection)

Parameter

existingEditorParts: EditorPartCollection

Eine ICollection vorhandener EditorPart-Steuerelemente in einer Zone.

editorParts: ICollection

Eine ICollection von EditorPart-Steuerelementen, die nicht in einer Zone vorhanden sind, sondern programmgesteuert erstellt wurden.

Siehe auch

ASP.NET Webparts Steuerelemente

Gilt für: