Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase WebPartCollection

 

Publicado: octubre de 2016

Contiene una colección de controles WebPart utilizados para realizar un seguimiento y administrar grupos de controles relacionados. Esta clase no puede heredarse.

Espacio de nombres:   System.Web.UI.WebControls.WebParts
Ensamblado:  System.Web (en System.Web.dll)

System.Object
  System.Collections.ReadOnlyCollectionBase
    System.Web.UI.WebControls.WebParts.WebPartCollection

public sealed class WebPartCollection : ReadOnlyCollectionBase

NombreDescripción
System_CAPS_pubmethodWebPartCollection()

Inicializa una nueva instancia vacía de la WebPartCollection clase.

System_CAPS_pubmethodWebPartCollection(ICollection)

Inicializa una nueva instancia de un WebPartCollection objeto pasando un ICollection colección de WebPart controles.

NombreDescripción
System_CAPS_pubpropertyCount

Obtiene el número de elementos incluidos en la instancia de ReadOnlyCollectionBase.(Heredado de ReadOnlyCollectionBase).

System_CAPS_pubpropertyItem[Int32]

Devuelve a un miembro de la colección basándose en su posición en la colección.

System_CAPS_pubpropertyItem[String]

Devuelve a un miembro de la colección basándose en un identificador de cadena único.

NombreDescripción
System_CAPS_pubmethodContains(WebPart)

Devuelve un valor que indica si un control determinado existe en la colección.

System_CAPS_pubmethodCopyTo(WebPart[], Int32)

Copia la colección en una matriz de WebPart objetos.

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodGetEnumerator()

Devuelve un enumerador que recorre en iteración el ReadOnlyCollectionBase instancia.(Heredado de ReadOnlyCollectionBase).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodIndexOf(WebPart)

Devuelve la posición de un miembro específico de la colección.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa al objeto actual. (Heredado de Object).

NombreDescripción
System_CAPS_pubinterfaceSystem_CAPS_privmethodICollection.CopyTo(Array, Int32)

Copia la totalidad de ReadOnlyCollectionBase en una matriz Array unidimensional compatible, comenzando en el índice especificado de la matriz de destino.(Heredado de ReadOnlyCollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.IsSynchronized

Obtiene un valor que indica si el acceso a un objeto ReadOnlyCollectionBase está sincronizado (es seguro para subprocesos).(Heredado de ReadOnlyCollectionBase).

System_CAPS_pubinterfaceSystem_CAPS_privpropertyICollection.SyncRoot

Obtiene un objeto que se puede utilizar para sincronizar el acceso a un objeto ReadOnlyCollectionBase.(Heredado de ReadOnlyCollectionBase).

NombreDescripción
System_CAPS_pubmethodAsParallel()

Sobrecargado. Habilita la paralelización de una consulta.(Definido por ParallelEnumerable).

System_CAPS_pubmethodAsQueryable()

Sobrecargado. Convierte un IEnumerable para un IQueryable.(Definido por Queryable).

System_CAPS_pubmethodCast<TResult>()

Convierte los elementos de un IEnumerable al tipo especificado.(Definido por Enumerable).

System_CAPS_pubmethodOfType<TResult>()

Filtra los elementos de un IEnumerable basado en un tipo especificado.(Definido por Enumerable).

La WebPartCollection clase es una colección de sólo lectura de controles, que normalmente utilizado WebPartZoneBase y WebPartManager controles para administrar conjuntos de WebPart controles.

A WebPartManager control utiliza un WebPartCollection objeto para mantener una lista de todos el WebPart controles en una página, mientras que un WebPartZoneBase control utiliza un WebPartCollection objeto que se va a realizar un seguimiento de la WebPart controles que contiene.

System_CAPS_noteNota

El WebPartCollection colección contiene WebPart controles y otros controles de servidor (como controles ASP.NET, controles personalizados y controles de usuario) que se colocan en WebPartZoneBase zonas y se utiliza como parte de las aplicaciones de elementos Web. Así, por ejemplo, si tiene un WebPartZone en una página de la zona y en él se declara un personalizado WebPart control y ASP.NET Calendar (control), ambos controles estarán en la WebPartCollection que haga referencia el WebParts propiedad.

La WebPartCollection objeto existe para que el conjunto de controles de elementos Web puede trabajar con colecciones fuertemente tipadas. De forma similar, si desea realizar operaciones masivas en un conjunto de WebPart controles, puede obtener una referencia a un WebPartCollection objeto mediante el WebParts propiedad. Por ejemplo, puede recorrer todos los WebPart controles de una página y cambiar su aspecto de alguna manera. Aunque la WebPartCollection objeto es de solo lectura, puede realizar cambios mediante programación a las propiedades de los controles subyacentes que se hace referencia en la colección.

En el ejemplo de código siguiente se muestra el uso de la WebPartCollection objeto en una página de elementos Web. Este ejemplo tiene tres partes:

  • El código de la página en una clase parcial.

  • La página Web que contiene los controles.

  • Descripción de cómo funciona el ejemplo en un explorador.

La primera parte del ejemplo de código contiene el código de la página en una clase parcial. Tenga en cuenta que el Button1_Click método crea un WebPartCollection objeto que consta de todos los el WebPart controles que se hace referenciados en el WebPartManager.WebParts propiedad, que incluye todas la WebPart controles de la página. El método recorre en iteración todos los controles y alterna cada control ChromeState propiedad que determina si ese control está normal o minimizado.

using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

public partial class webpartcollectioncs : System.Web.UI.Page
{
  protected void Button1_Click(object sender, EventArgs e)
  {

    WebPartCollection partCollection = mgr1.WebParts;

    foreach (WebPart part in partCollection)
    {
      if (part.ChromeState != PartChromeState.Minimized)
        part.ChromeState = PartChromeState.Minimized;
      else
        part.ChromeState = PartChromeState.Normal;
    }
  }
  protected void Button2_Click(object sender, EventArgs e)
  {
    WebPartCollection partCollection = WebPartZone1.WebParts;

    if (partCollection[0].Title == "My Link List")
      partCollection[0].Title = "Favorite Links";
    else
      partCollection[0].Title = "My Link List";
  }
}

La segunda parte del ejemplo de código es la página Web que contiene los controles. Observe que los controles declarados en WebPartZone1 son controles de servidor ASP.NET estándar, pero dado que se ajustan como GenericWebPart controles en tiempo de ejecución y la GenericWebPart clase hereda de la WebPart (clase), los controles se tratan automáticamente como WebPart controles en tiempo de ejecución y, por tanto, se incluyen en la WebPartCollection objeto.

<%@ Page Language="C#" 
  Codefile="webpartcollection.cs" 
  Inherits="webpartcollectioncs" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Untitled Page</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
      <asp:WebPartManager ID="mgr1" runat="server" />
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
          <br />
          <asp:Calendar ID="Calendar1" runat="server" 
            Title="My Calendar" />
        </ZoneTemplate>
      </asp:WebPartZone>
    </div>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ChromeState" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
        Text="Toggle BulletedList1 Title" 
        OnClick="Button2_Click"/>
    </form>
</body>
</html>

Después de cargar la página en un explorador y haga clic en el Alternar ChromeState botón, el código de la clase parcial recorre el WebPartCollection de objeto y también minimiza los controles o los devuelve al normal. O bien, si hace clic repetidamente en el Alternar título de BulletedList1 botón, el título del control superior se cambia a valores alternativos.

.NET Framework
Disponible desde 2.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: