IWebEditable.CreateEditorParts Método
Definição
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.
Retorna uma coleção de controles EditorPart personalizados associados a um controle de servidor que implementa a interface IWebEditable.
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 EditorPartCollectionRetornos
Uma EditorPartCollection que contém a coleção de controles personalizados EditorPart associados a um controle de servidor.
Exemplos
O exemplo de código a seguir demonstra uma substituição do CreateEditorParts método em um controle personalizado WebPart . O código-fonte completo necessário para executar o exemplo é encontrado na seção Exemplo do tópico de visão geral da IWebEditable classe.
O exemplo de código contém ambos os membros da IWebEditable interface. Observe que a substituição do CreateEditorParts método cria um ArrayList para coletar um ou mais controles personalizados EditorPart e, em seguida, 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
Comentários
O CreateEditorParts método permite que você crie uma coleção de todos os controles personalizados EditorPart associados ao controle personalizado, WebPart controle ou controle de usuário e retorne-os como um EditorPartCollection objeto. O WebPartManager controle usa a coleção e cria instâncias de todos os EditorPart controles sempre que o controle do servidor entra no modo de edição.
Normalmente, você implementa esse método em um controle personalizado WebPart substituindo seu CreateEditorParts método. No método , você cria instâncias dos controles personalizados EditorPart que deseja associar aos controles, adiciona-as a um EditorPartCollection objeto e retorna esse objeto. A coleção de EditorPart controles é então atribuída à EditorParts propriedade da EditorZoneBase zona.
Observação
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 .
Notas aos Implementadores
O EditorPartCollection objeto que o CreateEditorParts() método retorna é somente leitura e não tem nenhum método acessível para adicionar controles individuais a ele. No entanto, em sua substituição ou implementação do método , você pode criar outro tipo de ICollection objeto, como um ArrayList, para conter todos os controles personalizados EditorPart e passá-lo para o construtor ao criar um novo EditorPartCollection objeto. Para obter um exemplo de código, consulte a seção Exemplo.
