WebPartManagerInternals Classe

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

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 sealed

public sealed class WebPartManagerInternals

type WebPartManagerInternals = class

Public NotInheritable Class WebPartManagerInternals

Ereditarietà

Object

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)	Imposta la proprietà IsClosed di un controllo WebPart.
SetIsShared(WebPart, Boolean)	Imposta la proprietà IsShared di un controllo WebPart.
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)	Imposta la proprietà IsStatic di un controllo WebPart.
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)

Vedi anche

• WebPartManager
• controlli web part ASP.NET