Compartir a través de

EditorPartCollection Constructores

  • Referencia

Definición

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

Inicializa una nueva instancia de la clase EditorPartCollection.

Sobrecargas

EditorPartCollection()

Inicializa una nueva instancia vacía de la clase EditorPartCollection.
EditorPartCollection(ICollection)

Inicializa una nueva instancia de la clase EditorPartCollection pasando una colección ICollection de controles EditorPart.
EditorPartCollection(EditorPartCollection, ICollection)

Inicializa una nueva instancia de la clase EditorPartCollection pasando una colección EditorPartCollection de controles EditorPart y una colección ICollection de controles EditorPart adicionales.

EditorPartCollection()

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

public:
 EditorPartCollection();
public EditorPartCollection ();
Public Sub New ()

Comentarios

El EditorPartCollection constructor inicializa una instancia vacía de la EditorPartCollection clase . La clase de su CreateEditorParts método usa internamente EditorZone esta sobrecarga del constructor para crear un objeto de colección vacío. A continuación, la zona crea instancias de todos los EditorPart controles declarados en la plantilla de zona secundaria y usa un método interno para agregarlos a la colección.

No puede usar esta sobrecarga del EditorPartCollection constructor para crear una nueva instancia de EditorPartCollection y agregarle EditorPart controles. En su lugar, debe usar una de las otras sobrecargas para el EditorPartCollection constructor.

Consulte también

Se aplica a

EditorPartCollection(ICollection)

Inicializa una nueva instancia de la clase EditorPartCollection pasando una colección ICollection de controles EditorPart.

public:
 EditorPartCollection(System::Collections::ICollection ^ editorParts);
public EditorPartCollection (System.Collections.ICollection editorParts);
new System.Web.UI.WebControls.WebParts.EditorPartCollection : System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.EditorPartCollection
Public Sub New (editorParts As ICollection)

Parámetros

editorParts
ICollection

Colección ICollection de controles EditorPart.

Ejemplos

En el ejemplo de código siguiente se muestra cómo crear un personalizado EditorPartCollection y, aunque la colección es de solo lectura, sigue realizando una operación por lotes para cambiar los controles individuales EditorPart de la colección. Para obtener el código completo necesario para ejecutar el ejemplo, consulte la sección Ejemplo de la información general de la EditorPartCollection clase.

El código del Button1_Click evento crea un ArrayList objeto , agrega dos de los tres EditorPart controles de la página al objeto y, a continuación, crea un nuevo EditorPartCollection objeto mediante el EditorPartCollection constructor . También muestra cómo puede realizar cambios en los controles subyacentes EditorPart , aunque la colección sea de solo lectura.

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

Puede cargar la página en un explorador y cambiar la página al modo de edición seleccionando Editar en el control de lista desplegable Modo de visualización. Puede hacer clic en el menú verbos (la flecha hacia abajo) en la barra de título del TextDisplayWebPart control y hacer clic en Editar para editar el control. Cuando la interfaz de usuario (UI) de edición está visible, puede ver todos los EditorPart controles. Haga clic en el botón Crear EditorPartCollection para ver los efectos en los dos EditorPart controles que se agregan al EditorPartCollection objeto .

Comentarios

El EditorPartCollection constructor inicializa una instancia de la EditorPartCollection clase y pasa una colección de EditorPart controles. Se trata de una sobrecarga del EditorPartCollection constructor que puede usar para crear un nuevo EditorPartCollection objeto y agregarle EditorPart controles.

Aunque la EditorPartCollection instancia creada por el constructor es de solo lectura, todavía puede acceder a los controles individuales EditorPart de la colección mediante programación y llamar a sus propiedades y métodos.

Un escenario común para usar el EditorPartCollection constructor sería si desea realizar alguna operación por lotes en un conjunto completo de EditorPart controles, como cambiar el contenido, la apariencia o la posición de un grupo relacionado de ellos.

Otro escenario común para usar el EditorPartCollection constructor es desarrollar controles personalizados EditorPart que desea asociar a un control de servidor, de modo que los usuarios puedan editar propiedades personalizadas en el control. En este escenario, el control de servidor debe implementar la IWebEditable interfaz y, como parte de esa tarea, debe implementar el CreateEditorParts método . En ese método, para habilitar los controles personalizados EditorPart para editar el control de servidor, debe agregar los EditorPart controles a una ICollection instancia, como un ArrayList objeto . A continuación, puede pasar la colección de EditorPart controles al EditorPartCollection constructor para crear un nuevo EditorPartCollection objeto, que la EditorZoneBase zona usa para configurar todos los controles y comenzar el proceso de edición.

Consulte también

Se aplica a

EditorPartCollection(EditorPartCollection, ICollection)

Inicializa una nueva instancia de la clase EditorPartCollection pasando una colección EditorPartCollection de controles EditorPart y una colección ICollection de controles EditorPart adicionales.

public:
 EditorPartCollection(System::Web::UI::WebControls::WebParts::EditorPartCollection ^ existingEditorParts, System::Collections::ICollection ^ editorParts);
public EditorPartCollection (System.Web.UI.WebControls.WebParts.EditorPartCollection existingEditorParts, System.Collections.ICollection editorParts);
new System.Web.UI.WebControls.WebParts.EditorPartCollection : System.Web.UI.WebControls.WebParts.EditorPartCollection * System.Collections.ICollection -> System.Web.UI.WebControls.WebParts.EditorPartCollection
Public Sub New (existingEditorParts As EditorPartCollection, editorParts As ICollection)

Parámetros

existingEditorParts
EditorPartCollection

ICollection de los controles EditorPart existentes en una zona.

editorParts
ICollection

ICollection de los controles EditorPart que no pertenecen a una zona, pero que se han creado mediante programación.

Consulte también

Se aplica a