EditorPartCollection.CopyTo(EditorPart[], Int32) Méthode

Référence

Définition

Espace de noms:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Copie la collection dans un tableau de contrôles EditorPart.

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)

Paramètres

array: EditorPart[]

EditorPart pour contenir la collection copiée de contrôles.

index: Int32

Point de départ du tableau qui contiendra le contenu de collection.

Exemples

L’exemple de code suivant montre comment utiliser la CopyTo méthode pour créer un tableau personnalisé de EditorPart contrôles. Pour obtenir le code complet requis pour exécuter l’exemple, consultez la section Exemple de la vue d’ensemble de la EditorPartCollection classe.

Le code dans l’événement Button1_Click crée un tableau de EditorPart contrôles, ajoute le LayoutEditorPart1 contrôle au tableau, puis utilise la CopyTo méthode pour copier les contrôles de l’objet EditorPartCollection vers le tableau.

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

Lorsque vous chargez la page dans un navigateur, vous pouvez basculer la page en mode édition en sélectionnant Modifier dans le contrôle de liste déroulante Mode d’affichage . Vous pouvez cliquer sur le menu des verbes (flèche vers le bas) dans la barre de titre du TextDisplayWebPart contrôle, puis cliquer sur Modifier pour modifier le contrôle. Lorsque l’interface utilisateur de modification est visible, vous pouvez voir tous les EditorPart contrôles. Si vous cliquez sur le bouton Créer un éditeurPartCollection , vous remarquerez que les titres de tous les contrôles dans le tableau personnalisé sont répertoriés en bas de la page.

Remarques

La CopyTo méthode est utile lorsque vous souhaitez créer un tableau personnalisé qui peut contenir les EditorPart contrôles dans l’objet EditorPartCollection , un sous-ensemble de ces contrôles ou un sur-ensemble de ces contrôles.

S’applique à

Voir aussi

contrôles webPart ASP.NET

Partager via