WebPartZone.GetInitialWebParts Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Esegue l'override del metodo base astratto e ottiene l'insieme iniziale di controlli WebPart statici contenuti nel modello della 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 WebPartCollectionRestituisce
Un oggetto WebPartCollection che contiene tutti i controlli WebPart o altri controlli server contenuti nel modello della zona.
Commenti
Il GetInitialWebParts metodo fornisce un'implementazione del metodo di base GetInitialWebParts astratto. Il metodo di base non fornisce alcuna implementazione, ma dichiara il metodo in modo che le classi derivate possano personalizzare il modo in cui otterranno il set iniziale di controlli appartenenti a una zona, senza prendere in considerazione le modifiche alla personalizzazione.
Per ogni controllo server presente nella zona, viene chiamato il CreateWebPart metodo . Se un controllo eredita direttamente dalla WebPart classe , viene semplicemente aggiunto alla raccolta della WebParts zona (e alla raccolta simile del WebPartManager controllo). Se un controllo non eredita direttamente da WebPart, il set di controlli Web part esegue il wrapping del controllo con un GenericWebPart oggetto , che consente al controllo di comportarsi come un WebPart controllo in fase di esecuzione.
La WebPartZone classe implementa il metodo di base restituendo il set di controlli (se presenti) dichiarati in modo statico all'interno di un set di <zonetemplate> tag nel markup di una pagina di Web part. Se un PlaceHolder controllo viene dichiarato in una zona, vengono aggiunti i controlli figlio di tale controllo anziché il controllo stesso. Questa implementazione consente, ad esempio, di creare una WebPartZone zona in una pagina master e quindi di dichiarare singoli WebPart controlli o server in una pagina di contenuto. Se dichiari Literal i controlli in una WebPartZone zona, vengono ignorati.
Nota
La raccolta iniziale di controlli restituiti dal GetInitialWebParts metodo potrebbe essere diversa dalla raccolta effettiva in fase di esecuzione dei controlli in una zona, dopo che è stata eseguita la personalizzazione. Si supponga, ad esempio, di avere una pagina Web con due WebPartZone controlli e la prima contiene il controllo utente denominato dichiarato User1 in modo statico all'interno dei <zonetemplate> tag. Se un utente carica la pagina e trascina User1 nella seconda zona, User1 fa ancora parte della raccolta restituita chiamando il GetInitialWebParts metodo per la prima zona, perché viene dichiarata in tale zona. Ma in fase di esecuzione, quando il WebPartManager controllo carica i dati di personalizzazione, User1 viene effettivamente visualizzato nella seconda zona in cui l'utente lo ha trascinato.