EditorZoneBase.EditorParts Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém uma coleção de todos os EditorPart controlos contidos numa EditorZoneBase zona.
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.EditorPartCollectionPublic ReadOnly Property EditorParts As EditorPartCollectionValor de Propriedade
E EditorPartCollection que contém todos os controlos individuais EditorPart numa zona.
- Atributos
Exceções
Um EditorPart ser adicionado à coleção não tem um valor atribuído à sua propriedade ID.
Exemplos
O exemplo de código seguinte demonstra como aceder à EditorParts propriedade programaticamente. Para o código completo necessário para executar o exemplo, consulte a secção Exemplo do EditorZoneBase tópico de visão geral da aula.
A primeira parte do exemplo de código demonstra que a EditorParts propriedade contém referências a todos os EditorPart controlos que são referenciados declarativamente na 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>
A segunda parte do exemplo de código acede programaticamente à EditorParts propriedade e lista o ID de cada controlo num Label controlo.
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 num navegador, pode clicar no botão Display EditorParts Collection para listar os IDs de todos os EditorPart controlos referenciados na EditorParts propriedade.
Observações
A EditorParts propriedade fornece uma referência a um conjunto de todos os EditorPart controlos da zona. Refere-se tanto aos EditorPart controlos fornecidos com o conjunto de controlos Web Parts, como a quaisquer controlos personalizados EditorPart adicionados à zona. Como a coleção é apenas de leitura, os programadores que queiram criar controlos personalizados EditorPart para fins gerais de edição e adicioná-los à coleção devem sobrepor o CreateEditorParts método.
Se desenhar controlos personalizados EditorPart para editar um controlo específico WebPart , deve sobrescrever os elementos da IWebEditable interface — o CreateEditorParts método e a WebBrowsableObject propriedade — no WebPart controlo. A razão para sobrepor estes membros é permitir que o seu WebPart controlo crie os controlos personalizados EditorPart e os adicione à EditorParts coleção quando o seu controlo está a ser editado, e fornecer aos controlos de edição uma referência de objeto ao WebPart controlo que estão a editar. Se quiseres adicionar um controlo personalizado EditorPart para editar um controlo de servidor que não herda da WebPart classe, tens de implementar a IWebEditable interface na classe tal como farias com um WebPart controlo.
Note
Note que qualquer EditorPart um que seja adicionado à coleção de EditorPart controlos numa implementação do CreateEditorParts método deve ter um valor atribuído à sua propriedade ID, caso contrário será lançada uma exceção quando a coleção for atribuída à EditorParts propriedade.