IWebEditable.CreateEditorParts Método
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.
Devolve uma coleção de controlos personalizados EditorPart associados a um controlo de servidor que implementa a IWebEditable interface.
public:
System::Web::UI::WebControls::WebParts::EditorPartCollection ^ CreateEditorParts();public System.Web.UI.WebControls.WebParts.EditorPartCollection CreateEditorParts();abstract member CreateEditorParts : unit -> System.Web.UI.WebControls.WebParts.EditorPartCollectionPublic Function CreateEditorParts () As EditorPartCollectionDevoluções
E EditorPartCollection que contém a coleção de controlos personalizados EditorPart associados a um controlo de servidor.
Exemplos
O exemplo de código seguinte demonstra uma sobreposição do CreateEditorParts método num controlo personalizado WebPart . O código-fonte completo necessário para executar o exemplo encontra-se na secção Exemplo do IWebEditable tópico de visão geral da aula.
O exemplo de código contém ambos os membros da IWebEditable interface. Note que a sobreposição do CreateEditorParts método cria um ArrayList ou mais controlos personalizados EditorPart e depois usa a lista para criar o EditorPartCollection objeto.
public override EditorPartCollection CreateEditorParts()
{
ArrayList editorArray = new ArrayList();
TextDisplayEditorPart edPart = new TextDisplayEditorPart();
edPart.ID = this.ID + "_editorPart1";
editorArray.Add(edPart);
EditorPartCollection editorParts =
new EditorPartCollection(editorArray);
return editorParts;
}
public override object WebBrowsableObject
{
get { return this; }
}
Public Overrides Function CreateEditorParts() _
As EditorPartCollection
Dim editorArray As New ArrayList()
Dim edPart as New TextDisplayEditorPart()
edPart.ID = Me.ID & "_editorPart1"
editorArray.Add(edPart)
Dim editorParts As New EditorPartCollection(editorArray)
Return editorParts
End Function
Public Overrides ReadOnly Property WebBrowsableObject() _
As Object
Get
Return Me
End Get
End Property
Observações
O CreateEditorParts método permite-lhe criar uma coleção de todos os controlos personalizados EditorPart associados ao seu controlo personalizado, WebPart controlo ou controlo de utilizador, e devolvê-los como um EditorPartCollection objeto. O WebPartManager controlo pega na coleção e cria instâncias de todos os EditorPart controlos sempre que o controlo do servidor entra em modo de edição.
Normalmente, implementa-se este método num controlo personalizado WebPart , sobrescrevendo o seu CreateEditorParts método. No método, crias instâncias dos controlos personalizados EditorPart que queres associar aos teus controlos, adicionas-nos a um EditorPartCollection objeto e depois devolves esse objeto. A coleção de EditorPart controlos é então atribuída à EditorParts propriedade da EditorZoneBase zona.
Note
Qualquer um EditorPart 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.
Notas para Implementadores
O EditorPartCollection objeto que o CreateEditorParts() método devolve é apenas de leitura e não tem um método acessível para adicionar controlos individuais. No entanto, no seu override ou implementação do método, pode criar outro tipo de ICollection objeto, como um ArrayList, para conter todos os controlos personalizados EditorPart , e passá-lo para o construtor quando cria um novo EditorPartCollection objeto. Para um exemplo de código, veja a secção Exemplo.