EditorPartCollection Konstruktoren

Definition

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

Initialisiert eine neue Instanz der EditorPartCollection-Klasse.

Überlädt

Name Beschreibung
EditorPartCollection()

Initialisiert eine leere neue 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 Sammlung zusätzlicher EditorPart Steuerelemente übergeben wird.

EditorPartCollection()

Initialisiert eine leere neue 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 der CreateEditorParts Methode verwendet, um ein leeres Auflistungsobjekt zu erstellen. Die Zone erstellt dann Instanzen aller Steuerelemente, die EditorPart in der untergeordneten Zonenvorlage 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 von EditorPartCollection steuerelementen zu erstellen und ihr Steuerelemente hinzuzufügen EditorPart . Sie müssen stattdessen eine der anderen Überladungen für den EditorPartCollection Konstruktor verwenden.

Weitere Informationen

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

Ein ICollection Steuerelement EditorPart .

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine benutzerdefinierte EditorPartCollection Und auch dann, wenn die Auflistung schreibgeschützt ist, einen Batchvorgang ausführen, um die einzelnen EditorPart Steuerelemente in der Auflistung zu ändern. 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 ArrayList Objekt, fügt dem Objekt zwei der drei EditorPart Steuerelemente auf der Seite hinzu und erstellt dann ein 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 in den Bearbeitungsmodus wechseln, indem Sie im Dropdownlistensteuerelement "Anzeigemodus" die Option "Bearbeiten" auswählen. Sie können auf das Verbenmenü (nach unten) in der Titelleiste des TextDisplayWebPart Steuerelements klicken und auf "Bearbeiten" klicken, um das Steuerelement zu bearbeiten. Wenn die Bearbeitungs-Benutzeroberfläche (UI) sichtbar ist, können Sie alle EditorPart Steuerelemente sehen. Sie klicken auf die Schaltfläche "EditorPartCollection erstellen ", um die Effekte für 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 der EditorPartCollection Sie ein neues EditorPartCollection Objekt erstellen und ihr Steuerelemente hinzufügen EditorPart können.

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

Ein häufiges Szenario für die Verwendung des EditorPartCollection Konstruktors wäre, wenn Sie einen Batchvorgang für einen ganzen Satz von EditorPart Steuerelementen ausführen möchten, z. B. das Ändern des Inhalts, der Darstellung oder der Position einer zugehörigen Gruppe davon.

Ein weiteres gängiges Szenario für die Verwendung des EditorPartCollection Konstruktors besteht darin, benutzerdefinierte EditorPart Steuerelemente zu entwickeln, die Sie einem Serversteuerelement zuordnen möchten, damit Benutzer benutzerdefinierte Eigenschaften für Ihr Steuerelement bearbeiten können. In diesem Szenario muss das Serversteuerelement die IWebEditable Schnittstelle implementieren, und als Teil dieser Aufgabe muss es die CreateEditorParts Methode implementieren. Damit die benutzerdefinierten EditorPart Steuerelemente ihr Serversteuerelement bearbeiten können, müssen Sie die EditorPart Steuerelemente zu einer ICollection Instanz hinzufügen, z. B. einem ArrayList Objekt. Anschließend können Sie die Auflistung von EditorPart Steuerelementen an den EditorPartCollection Konstruktor übergeben, um ein neues EditorPartCollection Objekt zu erstellen, mit dem die EditorZoneBase Zone alle Steuerelemente einrichten und den Bearbeitungsprozess beginnt.

Weitere Informationen

Gilt für:

EditorPartCollection(EditorPartCollection, ICollection)

Initialisiert eine neue Instanz der EditorPartCollection Klasse, indem eine EditorPartCollection Auflistung von EditorPart Steuerelementen und eine ICollection Sammlung zusätzlicher EditorPart Steuerelemente ü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 der vorhandenen EditorPart Steuerelemente in einer Zone.

editorParts
ICollection

Ein ICollection Steuerelement EditorPart , das sich nicht in einer Zone befindet, sondern programmgesteuert erstellt wurde.

Weitere Informationen

Gilt für: