IWebEditable.CreateEditorParts Método

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

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

Public Function CreateEditorParts () As EditorPartCollection

Retornos

EditorPartCollection

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.

Confira também

• EditorPart
• controles de Web Parts ASP.NET