EditorPartCollection.CopyTo(EditorPart[], Int32) Methode
Definition
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.
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 mithilfe der CopyTo -Methode ein benutzerdefiniertes Array von Steuerelementen EditorPart erstellen. 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 das LayoutEditorPart1
Steuerelement dem Array hinzu und verwendet dann die CopyTo -Methode, um die Steuerelemente aus dem 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 in den Bearbeitungsmodus wechseln, indem Sie im Dropdownlistensteuerelement Anzeigemodus die Option Bearbeiten auswählen. Sie können auf das Verbenmenü (den Pfeil nach unten) in der Titelleiste des TextDisplayWebPart
Steuerelements klicken und dann auf Bearbeiten klicken, um das Steuerelement zu bearbeiten. Wenn die Bearbeitungs-Benutzeroberfläche (UI) sichtbar ist, werden alle EditorPart Steuerelemente angezeigt. Wenn Sie auf die Schaltfläche Editor erstellenPartCollection 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 Obermenge dieser Steuerelemente enthalten kann.