Partilhar via


WebPartZone.GetInitialWebParts Método

Definição

Substitui o método base abstrato e obtém o conjunto inicial de controles WebPart estáticos contidos no modelo da zona.

protected public:
 override System::Web::UI::WebControls::WebParts::WebPartCollection ^ GetInitialWebParts();
protected internal override System.Web.UI.WebControls.WebParts.WebPartCollection GetInitialWebParts ();
override this.GetInitialWebParts : unit -> System.Web.UI.WebControls.WebParts.WebPartCollection
Protected Friend Overrides Function GetInitialWebParts () As WebPartCollection

Retornos

Um WebPartCollection que contém todos os WebPart ou outros controles do servidor contidos no modelo da zona.

Comentários

O GetInitialWebParts método fornece uma implementação do método base GetInitialWebParts abstrato. O método base não fornece nenhuma implementação, mas declara o método para que as classes derivadas possam personalizar como obterão o conjunto inicial de controles que pertencem a uma zona, sem levar em conta as alterações de personalização.

Para cada controle de servidor encontrado na zona, o CreateWebPart método é chamado. Se um controle herdar diretamente da WebPart classe , ele será simplesmente adicionado à coleção da WebParts zona (e à coleção semelhante do WebPartManager controle). Se um controle não herdar diretamente de , o conjunto de WebPartcontrole de Web Parts encapsulará o controle com um GenericWebPart objeto , o que permite que o controle se comporte como um WebPart controle em tempo de execução.

A WebPartZone classe implementa o método base retornando o conjunto de controles (se houver) que são declarados estaticamente dentro de um conjunto de <zonetemplate> marcas na marcação de uma página de Web Parts. Se um PlaceHolder controle for declarado em uma zona, os controles filho desse controle serão adicionados, em vez do próprio controle. Essa implementação permite, por exemplo, criar uma WebPartZone zona em uma página mestra e declarar controles individuais WebPart ou de servidor em uma página de conteúdo. Se você declarar Literal controles em uma WebPartZone zona, eles serão ignorados.

Observação

A coleção inicial de controles retornados pelo GetInitialWebParts método pode ser diferente da coleção real de controles em tempo de execução em uma zona, após a personalização ter ocorrido. Por exemplo, suponha que você tenha uma página da Web com dois WebPartZone controles e o primeiro contenha o controle de usuário chamado User1 que é declarado estaticamente dentro das <zonetemplate> marcas. Se um usuário carregar a página e arrastar User1 para a segunda zona, User1 ainda será parte da coleção retornada chamando o GetInitialWebParts método para a primeira zona, pois ela é declarada nessa zona. Mas, em tempo de execução, quando o WebPartManager controle carrega os dados de personalização, User1 realmente aparece na segunda zona em que o usuário os arrastou.

Aplica-se a

Confira também