Sdílet prostřednictvím

EditorPartCollection.CopyTo(EditorPart[], Int32) Metoda

  • Reference

Definice

Obor názvů:
System.Web.UI.WebControls.WebParts
Sestavení:
System.Web.dll

Zkopíruje kolekci do pole ovládacích EditorPart prvků.

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)

Parametry

array
EditorPart[]

Chcete-li EditorPart obsahovat zkopírovanou kolekci ovládacích prvků.

index
Int32

Počáteční bod v poli, na který se má umístit obsah kolekce.

Příklady

Následující příklad kódu ukazuje, jak použít metodu CopyTo k vytvoření vlastní pole ovládacích EditorPart prvků. Úplný kód potřebný ke spuštění příkladu najdete v části Příklad přehledu EditorPartCollection třídy.

Kód v Button1_Click události vytvoří pole ovládacích EditorPart prvků, přidá LayoutEditorPart1 ovládací prvek do pole a pak použije metodu CopyTo ke zkopírování ovládacích prvků z objektu EditorPartCollection do pole.

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

Když stránku načtete v prohlížeči, můžete stránku přepnout do režimu úprav výběrem možnosti Upravit v ovládacím prvku rozevíracího seznamu Režim zobrazení . Můžete kliknout na nabídku sloves (šipku dolů) v záhlaví TextDisplayWebPart ovládacího prvku a kliknutím na Upravit ovládací prvek upravit. Když je uživatelské rozhraní pro úpravy viditelné, uvidíte všechny EditorPart ovládací prvky. Pokud kliknete na tlačítko Vytvořit editorPartCollection , všimněte si, že názvy všech ovládacích prvků ve vlastním poli jsou uvedeny v dolní části stránky.

Poznámky

Metoda CopyTo je užitečná, když chcete vytvořit vlastní pole, které může obsahovat EditorPart ovládací prvky v objektu EditorPartCollection , podmnožinu těchto ovládacích prvků nebo nadmnožinu těchto ovládacích prvků.

Platí pro

Viz také