EditorZoneBase.EditorParts Propriedade

Definição

Obtém uma coleção de todos os controles EditorPart contidos em uma zona EditorZoneBase.Gets a collection of all the EditorPart controls contained in an EditorZoneBase zone.

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 da propriedade

EditorPartCollection

Um EditorPartCollection que contém todos os EditorPart controles individuais em uma zona.An EditorPartCollection that contains all the individual EditorPart controls in a zone.

Atributos

Exceções

Um EditorPart que está sendo adicionado à coleção não tem um valor atribuído à sua propriedade de ID.An EditorPart being added to the collection does not have a value assigned to its ID property.

Exemplos

O exemplo de código a seguir demonstra como acessar a EditorParts propriedade de forma programática.The following code example demonstrates how to access the EditorParts property programmatically. Para obter o código completo necessário para executar o exemplo, consulte a seção de exemplo do EditorZoneBase tópico Visão geral da classe.For the full code required to run the example, see the Example section of the EditorZoneBase class overview topic.

A primeira parte do exemplo de código demonstra que a EditorParts propriedade contém referências a todos os EditorPart controles que são referenciados declarativamente na página da Web.The first part of the code example demonstrates that the EditorParts property contains references to all the EditorPart controls that are referenced declaratively in the Web page.

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

A segunda parte do exemplo de código acessa programaticamente a EditorParts propriedade e lista a ID de cada controle em um Label controle.The second part of the code example programmatically accesses the EditorParts property and lists the ID of each control in a 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

Ao carregar a página em um navegador, você pode clicar no botão Exibir coleção de EditorParts para listar as IDs de todos os EditorPart controles referenciados na EditorParts propriedade.When you load the page in a browser, you can click the Display EditorParts Collection button to list the IDs of all the EditorPart controls referenced in the EditorParts property.

Comentários

A EditorParts propriedade fornece uma referência a uma coleção de todos os EditorPart controles na zona.The EditorParts property provides a reference to a collection of all the EditorPart controls in the zone. Ele faz referência aos dois EditorPart controles fornecidos com o conjunto de controle de Web Parts e todos os EditorPart controles personalizados que são adicionados à zona.It references both the EditorPart controls provided with the Web Parts control set, and any custom EditorPart controls that are added to the zone. Como a coleção é somente leitura, os desenvolvedores que desejam criar EditorPart controles personalizados para fins de edição geral e adicioná-los à coleção devem substituir o CreateEditorParts método.Because the collection is read-only, developers who want to create custom EditorPart controls for general editing purposes and add them to the collection should override the CreateEditorParts method.

Se você criar EditorPart controles personalizados para editar um WebPart controle específico, deverá substituir os membros da IWebEditable interface – o CreateEditorParts método e a WebBrowsableObject propriedade--no WebPart controle.If you design custom EditorPart controls to edit a specific WebPart control, you should override the members of the IWebEditable interface--the CreateEditorParts method and the WebBrowsableObject property--in the WebPart control. O motivo para substituir esses membros é habilitar o WebPart controle para criar os controles personalizados EditorPart e adicioná-los à EditorParts coleção quando o controle está sendo editado e fornecer os controles de edição com uma referência de objeto ao WebPart controle que estão sendo editados.The reason to override these members is to enable your WebPart control to create the custom EditorPart controls and add them to the EditorParts collection when your control is being edited, and to provide the editing controls with an object reference to the WebPart control they are editing. Se você quiser adicionar um controle personalizado EditorPart para editar um controle de servidor que não herda da WebPart classe, você deve implementar a IWebEditable interface na classe da mesma forma que faria com um WebPart controle.If you want to add a custom EditorPart control to edit a server control that does not inherit from the WebPart class, you must implement the IWebEditable interface in the class just as you would for a WebPart control.

Observação

Observe que qualquer EditorPart um que seja adicionado à coleção de EditorPart controles em uma implementação do CreateEditorParts método deve ter um valor atribuído à sua propriedade ID, caso contrário, uma exceção será lançada quando a coleção for atribuída à EditorParts propriedade.Note that any EditorPart that is added to the collection of EditorPart controls in an implementation of the CreateEditorParts method must have a value assigned to its ID property, otherwise an exception will be thrown when the collection is assigned to the EditorParts property.

Aplica-se a

Confira também