WebPartManagerInternals Classe
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.
Isola in una classe distinta i metodi utilizzati dal controllo WebPartManager e che possono essere sottoposti a override dagli sviluppatori che estendono il controllo ma sono raramente richiesti dagli sviluppatori di pagine.
public ref class WebPartManagerInternals sealedpublic sealed class WebPartManagerInternalstype WebPartManagerInternals = classPublic NotInheritable Class WebPartManagerInternals- Ereditarietà
-
WebPartManagerInternals
Commenti
La WebPartManager classe è la classe più grande nel set di controlli Web part. È anche tra le classi Web part più importanti perché viene usata in ogni pagina Web che contiene controlli Web part e coordina e gestisce tutti i controlli Web part in una pagina.
Poiché la WebPartManager classe viene usata così frequentemente e perché contiene così tanti metodi esposti, alcuni metodi necessari principalmente per gli sviluppatori di controlli che estendono il WebPartManager controllo sono contenuti nella WebPartManagerInternals classe . Questo isolamento dei metodi meno usati nella WebPartManagerInternals classe semplifica l'API della WebPartManager classe e i metodi isolati non vengono visualizzati nell'oggetto WebPartManager in IntelliSense.
È probabile che gli sviluppatori che usano la WebPartManagerInternals classe abbiano scenari in cui devono ereditare dal WebPartManager controllo e personalizzarlo in modo esteso. Ad esempio, se si sta creando un'applicazione portale Web o un set in pacchetto di controlli Web part con modalità di visualizzazione personalizzate, zone personalizzate, verbi personalizzati, controlli personalizzati WebPart e altre estensioni dell'interfaccia utente delle web part di base, in molti casi (non tutti) è necessario eseguire l'override ed estendere alcuni WebPartManager membri. Sebbene la WebPartManagerInternals classe sia sealed, pertanto non è possibile ereditarla, è probabile che la classe personalizzata WebPartManager debba chiamare un certo numero di WebPartManagerInternals metodi per gestire i controlli Web part in una pagina.
Nota
Analogamente alla WebPartManager classe , la WebPartManagerInternals classe fornisce un controllo server senza interfaccia utente e non è mai visibile in una pagina. A differenza di WebPartManager, la WebPartManagerInternals classe non viene mai dichiarata nel markup di una pagina, ma è strettamente un oggetto worker che esegue attività in background. Il modo tipico di usarlo è dimostrato dalla WebPartManager classe , che la fa riferimento tramite la proprietà protetta Internals e usa l'oggetto a cui si fa riferimento per chiamare i WebPartManagerInternals metodi.
La WebPartManagerInternals classe contiene solo metodi. Non sono presenti proprietà o eventi. Tutti i metodi della classe comportano la gestione di WebPart controlli o connessioni tra i controlli.
Per gestire WebPart i controlli, WebPartManagerInternals include i metodi per aggiungerli (AddWebPart), rimuoverli RemoveWebPart, gestire gli eventi CallOnDeleting), ottenere o impostare i dettagli sulla relazione con la propria zona (ad esempio, GetZoneID e SetZoneIndex) o l'impostazione delle proprietà del controllo di base WebPart (ad esempio SetIsClosed , e SetHasSharedData).
Per gestire le connessioni, WebPartManagerInternals include i metodi per eliminarli (DeleteConnection), impostando l'oggetto trasformatore da utilizzare (SetTransformer), impostando se una connessione è condivisa e se è statica (SetIsShared(WebPartConnection, Boolean) e SetIsStatic(WebPartConnection, Boolean)) e impostando un messaggio di errore di connessione da usare (SetConnectErrorMessage).
Metodi
| AddWebPart(WebPart) |
Aggiunge un controllo WebPart o un controllo server all'insieme di controlli WebPartManager del controllo WebPart in una pagina Web. |
| CallOnClosing(WebPart) |
Chiama il metodo OnClosing(EventArgs) del controllo specificato. |
| CallOnConnectModeChanged(WebPart) |
Chiama il metodo OnConnectModeChanged(EventArgs) del controllo specificato. |
| CallOnDeleting(WebPart) |
Chiama il metodo OnDeleting(EventArgs) del controllo specificato. |
| CallOnEditModeChanged(WebPart) |
Chiama il metodo OnEditModeChanged(EventArgs) del controllo specificato. |
| ConnectionDeleted(WebPartConnection) |
Indica se l'oggetto WebPartConnection specificato è stato o meno eliminato. |
| CreateObjectFromType(Type) |
Crea un oggetto in base al parametro passato al metodo. |
| DeleteConnection(WebPartConnection) |
Imposta una proprietà per indicare che l'oggetto connessione specificato è stato eliminato. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| GetZoneID(WebPart) |
Ottiene l'ID di una zona che contiene il controllo WebPart o il controllo server specificato. |
| LoadConfigurationState(WebPartTransformer, Object) |
Carica i dati sullo stato precedentemente salvati per un oggetto WebPartTransformer che partecipa a una connessione tra controlli. |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| RemoveWebPart(WebPart) |
Rimuove un controllo WebPart o un altro controllo server dall'insieme di controlli del controllo WebPartManager. |
| SaveConfigurationState(WebPartTransformer) |
Salva i dati sullo stato per un oggetto WebPartTransformer che partecipa a una connessione tra controlli. |
| SetConnectErrorMessage(WebPart, String) |
Determina un messaggio di errore e l'oggetto WebPartChrome responsabile del rendering di un controllo WebPart esegue il rendering del messaggio anziché quello del contenuto del controllo. |
| SetHasSharedData(WebPart, Boolean) |
Imposta una proprietà su un oggetto WebPart o su un altro controllo server che indica se il controllo dispone o meno di dati condivisi sulla personalizzazione. |
| SetHasUserData(WebPart, Boolean) |
Imposta una proprietà su un oggetto WebPart o su un altro controllo server che indica se il controllo dispone o meno di dati sulla personalizzazione utente. |
| SetIsClosed(WebPart, Boolean) | |
| SetIsShared(WebPart, Boolean) | |
| SetIsShared(WebPartConnection, Boolean) |
Imposta la proprietà IsShared di un oggetto WebPartConnection. |
| SetIsStandalone(WebPart, Boolean) |
Imposta la proprietà IsStandalone di un controllo WebPart. |
| SetIsStatic(WebPart, Boolean) | |
| SetIsStatic(WebPartConnection, Boolean) |
Imposta la proprietà IsStatic di un oggetto WebPartConnection. |
| SetTransformer(WebPartConnection, WebPartTransformer) |
Assegna un oggetto WebPartTransformer da utilizzare in una connessione tra due controlli server. |
| SetZoneID(WebPart, String) |
Imposta una proprietà che consente a un oggetto WebPart o a un controllo server di mantenere l'ID della zona che lo contiene. |
| SetZoneIndex(WebPart, Int32) |
Imposta l'indice del controllo specificato all'interno della relativa zona rispetto agli altri controlli WebPart presenti nella zona. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
