EditorZoneBase.EditorParts Propiedad

Definición

Obtiene una colección de todos los controles EditorPart contenidos en una zona EditorZoneBase.

public:
 property System::Web::UI::WebControls::WebParts::EditorPartCollection ^ EditorParts { System::Web::UI::WebControls::WebParts::EditorPartCollection ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.UI.WebControls.WebParts.EditorPartCollection EditorParts { get; }
[<System.ComponentModel.Browsable(false)>]
member this.EditorParts : System.Web.UI.WebControls.WebParts.EditorPartCollection
Public ReadOnly Property EditorParts As EditorPartCollection

Valor de propiedad

Una colección EditorPartCollection que contiene todos los controles EditorPart individuales de una zona.

Atributos

Excepciones

Un EditorPart que se va a agregar a la colección no tiene asignado ningún valor a su propiedad ID.

Ejemplos

En el ejemplo de código siguiente se muestra cómo obtener acceso a la EditorParts propiedad mediante programación. Para obtener el código completo necesario para ejecutar el ejemplo, vea la sección Ejemplo del tema de información general de la EditorZoneBase clase.

La primera parte del ejemplo de código muestra que la EditorParts propiedad contiene referencias a todos los EditorPart controles a los que se hace referencia mediante declaración en la página web.

<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>
<aspSample:MyEditorZone ID="EditorZone1" runat="server">
  <ApplyVerb Text="Apply Changes" />
  <CancelVerb Text="Cancel Changes" />
  <OKVerb Text="Finished" />
  <ZoneTemplate>
    <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
      runat="server" />
    <asp:LayoutEditorPart ID="LayoutEditorPart1" 
      runat="server" />
  </ZoneTemplate>
</aspSample:MyEditorZone>

La segunda parte del ejemplo de código accede mediante programación a la EditorParts propiedad y enumera el identificador de cada control de un Label control.

void Button3_Click(object sender, EventArgs e)
{
  Label1.Text = "<br />";
  foreach (EditorPart part in EditorZone1.EditorParts)
  {
    Label1.Text += part.ID + "<br />";
  }
}
Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
  Label1.Text = "<br />"
  Dim part As EditorPart
  For Each part In EditorZone1.EditorParts
    Label1.Text += part.ID + "<br />"
  Next part
End Sub

Al cargar la página en un explorador, puede hacer clic en el botón Mostrar editorParts Collection para mostrar los identificadores de todos los controles a los EditorPart que se hace referencia en la EditorParts propiedad .

Comentarios

La EditorParts propiedad proporciona una referencia a una colección de todos los EditorPart controles de la zona. Hace referencia a los EditorPart controles proporcionados con el conjunto de controles de elementos web y a los controles personalizados EditorPart que se agregan a la zona. Dado que la colección es de solo lectura, los desarrolladores que desean crear controles personalizados EditorPart con fines de edición generales y agregarlos a la colección deben invalidar el CreateEditorParts método .

Si diseña controles personalizados EditorPart para editar un control específico WebPart , debe invalidar los miembros de la IWebEditable interfaz,el CreateEditorParts método y la WebBrowsableObject propiedad del WebPart control . La razón para invalidar estos miembros es permitir que el WebPart control cree los controles personalizados EditorPart y agréguelos a la EditorParts colección cuando se edite el control y para proporcionar los controles de edición con una referencia de objeto al WebPart control que están editando. Si desea agregar un control personalizado EditorPart para editar un control de servidor que no hereda de la WebPart clase , debe implementar la IWebEditable interfaz en la clase igual que lo haría para un WebPart control.

Nota:

Tenga en cuenta que cualquiera EditorPart que se agregue a la colección de controles de EditorPart una implementación del CreateEditorParts método debe tener un valor asignado a su propiedad ID; de lo contrario, se producirá una excepción cuando se asigne la colección a la EditorParts propiedad .

Se aplica a

Consulte también