Share via

IWebEditable.CreateEditorParts Método

  • Referência

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, WebPart controle ou controle do usuário personalizados e os retorne 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-os a um EditorPartCollection objeto e, em seguida, retorna esse objeto. A coleção de EditorPart controles é 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 quando você criar um novo EditorPartCollection objeto. Para obter um exemplo de código, consulte a seção Exemplo.

Aplica-se a

Confira também