EditorPartCollection.CopyTo(EditorPart[], Int32) Methode

  • Referenz

Definition

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

Kopiert die Auflistung in ein Array von EditorPart-Steuerelementen.

public:
 void CopyTo(cli::array <System::Web::UI::WebControls::WebParts::EditorPart ^> ^ array, int index);
public void CopyTo (System.Web.UI.WebControls.WebParts.EditorPart[] array, int index);
member this.CopyTo : System.Web.UI.WebControls.WebParts.EditorPart[] * int -> unit
Public Sub CopyTo (array As EditorPart(), index As Integer)

Parameter

array
EditorPart[]

Ein EditorPart, der als Container für die kopierte Auflistung der Steuerelemente fungiert.

index
Int32

Der Ausgangspunkt im Array, an dem der Inhalt der Auflistung platziert werden soll.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie die CopyTo Methode zum Erstellen eines benutzerdefinierten Arrays von EditorPart Steuerelementen verwenden. 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 Array von EditorPart Steuerelementen, fügt LayoutEditorPart1 das Steuerelement dem Array hinzu, und verwendet dann die CopyTo Methode, um die Steuerelemente vom EditorPartCollection Objekt in das Array zu kopieren.

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

Wenn Sie die Seite in einem Browser laden, können Sie 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. Wenn Sie auf die Schaltfläche "EditorPartCollection erstellen " klicken, werden Sie feststellen, dass die Titel aller Steuerelemente im benutzerdefinierten Array am unteren Rand der Seite aufgeführt sind.

Hinweise

Die CopyTo Methode ist nützlich, wenn Sie ein benutzerdefiniertes Array erstellen möchten, das die EditorPart Steuerelemente im EditorPartCollection Objekt, eine Teilmenge dieser Steuerelemente oder eine Übermenge dieser Steuerelemente enthalten kann.

Gilt für

Siehe auch