WebPartZone.GetInitialWebParts 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.
Sobrepõe o método base abstrato e obtém o conjunto inicial de controlos estáticos WebPart contidos no template 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.WebPartCollectionProtected Friend Overrides Function GetInitialWebParts () As WebPartCollectionDevoluções
A WebPartCollection que contém todos os WebPart ou outros controlos de servidor contidos no modelo da zona.
Observações
O GetInitialWebParts método fornece uma implementação do método base GetInitialWebParts abstrato. O método base não fornece implementação, mas declara o método para que as classes derivadas possam personalizar como irão obter o conjunto inicial de controlos que pertencem a uma zona, sem ter em conta as alterações de personalização.
Para cada controlo de servidor encontrado na zona, é chamado o CreateWebPart método. Se um controlo herda diretamente da WebPart classe, é simplesmente adicionado à coleção da WebParts zona (e à coleção semelhante do WebPartManager controlo). Se um controlo não herda diretamente de WebPart, o conjunto de controlos Web Parts envolve o controlo com um GenericWebPart objeto, o que permite que o controlo se comporte como um WebPart controlo em tempo de execução.
A WebPartZone classe implementa o método base ao devolver o conjunto de controlos (se existirem) que são declarados estaticamente dentro de um conjunto de <zonetemplate> etiquetas na marcação de uma página de Web Parts. Se um PlaceHolder controlo for declarado numa zona, os controlos filhos desse controlo são adicionados, em vez do controlo em si. Esta implementação permite, por exemplo, criar uma WebPartZone zona numa página mestre e depois declarar controlos individuais WebPart ou de servidor numa página de conteúdo. Se declarares Literal controlos numa WebPartZone zona, eles são ignorados.
Note
A coleção inicial de controlos devolvida pelo GetInitialWebParts método pode ser diferente da coleção real de controlos em tempo de execução numa zona, após a personalização ter ocorrido. Por exemplo, suponha que tem uma página Web com dois WebPartZone controlos, e o primeiro contém um controlo de utilizador nomeado User1 que é declarado estaticamente dentro das <zonetemplate> etiquetas. Se um utilizador carregar a página e arrastar User1 para a segunda zona, então User1 ainda faz parte da coleção que é devolvida ao chamar o GetInitialWebParts método para a primeira zona, porque está declarado nessa zona. Mas em tempo de execução, quando o controlo WebPartManager carrega os dados de personalização, User1 eles aparecem na segunda zona onde o utilizador os arrastou.