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

Referência

Definição

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

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Copia a coleção em uma matriz de controles 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)

Parâmetros

array: EditorPart[]

Um EditorPart para conter a coleção copiada de controles.

index: Int32

O ponto inicial na matriz na qual o conteúdo da coleção será colocado.

Exemplos

O exemplo de código a seguir demonstra como usar o CopyTo método para criar uma matriz personalizada de EditorPart controles. Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo da visão geral da EditorPartCollection classe.

O código no Button1_Click evento cria uma matriz de EditorPart controles, adiciona o LayoutEditorPart1 controle à matriz e usa o CopyTo método para copiar os controles do EditorPartCollection objeto para a matriz.

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

Ao carregar a página em um navegador, você pode alternar a página para o modo de edição selecionando Editar no controle de lista suspensa Modo de Exibição . Você pode clicar no menu de verbos (a seta para baixo) na barra de título do TextDisplayWebPart controle e clicar em Editar para editar o controle. Quando a interface do usuário (interface do usuário) de edição estiver visível, você poderá ver todos os EditorPart controles. Se você clicar no botão Criar EditorPartCollection , observará que os títulos de todos os controles na matriz personalizada estão listados na parte inferior da página.

Comentários

O CopyTo método é útil quando você deseja criar uma matriz personalizada que pode conter os EditorPart controles no EditorPartCollection objeto, um subconjunto desses controles ou um superconjunto desses controles.

Aplica-se a

Confira também

Controles de Web Parts do ASP.NET

Partilhar via