EditorZoneBase.EditorParts Propriedade

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.

Obtém uma coleção de todos os controles EditorPart contidos em uma 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 da propriedade

EditorPartCollection

Um EditorPartCollection que contém todos os controles individuais EditorPart em uma zona.

Atributos: BrowsableAttribute

Exceções

InvalidOperationException

Um EditorPart que está sendo adicionado à coleção não tem um valor atribuído à sua propriedade de ID.

Exemplos

O exemplo de código a seguir demonstra como acessar a EditorParts propriedade programaticamente. Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo do tópico visão geral da EditorZoneBase classe.

A primeira parte do exemplo de código demonstra que a EditorParts propriedade contém referências a todos os EditorPart controles referenciados declarativamente na página da 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>

A segunda parte do exemplo de código acessa programaticamente a EditorParts propriedade e lista a ID de cada controle em um Label controle.

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 EditorPartes Coleção para listar as IDs de todos os EditorPart controles referenciados na EditorParts propriedade .

Comentários

A EditorParts propriedade fornece uma referência a uma coleção de todos os EditorPart controles na zona. Ele faz referência aos EditorPart controles fornecidos com o conjunto de controles de Web Parts e a todos os controles personalizados EditorPart adicionados à zona. Como a coleção é somente leitura, os desenvolvedores que desejam criar controles personalizados EditorPart para fins gerais de edição e adicioná-los à coleção devem substituir o CreateEditorParts método .

Se você criar controles personalizados EditorPart para editar um controle específico WebPart , deverá substituir os membros da IWebEditable interface – o CreateEditorParts método e a WebBrowsableObject propriedade – no WebPart controle . O motivo para substituir esses membros é permitir que o WebPart controle crie os controles personalizados EditorPart e adicioná-los à coleção quando o EditorParts controle estiver sendo editado e fornecer aos controles de edição uma referência de objeto ao WebPart controle que eles estão editando. Se você quiser adicionar um controle personalizado EditorPart para editar um controle de servidor que não herda da WebPart classe , deverá implementar a IWebEditable interface na classe exatamente como faria para um WebPart controle .

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á gerada quando a coleção for atribuída à EditorParts propriedade .

Aplica-se a

Partilhar via