WebPartManagerInternals Classe

Definizione

Spazio dei nomi:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Isola in un metodo di classe separato usato dal WebPartManager controllo e può essere sottoposto a override dagli sviluppatori che estendono il controllo, ma sono raramente necessari per gli 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 dagli 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 compila 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 membri WebPartManager . Anche se la WebPartManagerInternals classe è sealed in modo da non poter ereditare da essa, è probabile che la classe personalizzata WebPartManager debba chiamare un certo numero di WebPartManagerInternals metodi per gestire i controlli Web part in una pagina.

Annotazioni

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 vi 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 dei WebPart controlli o le connessioni tra i controlli.

Per gestire WebPart i controlli, WebPartManagerInternals include 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 impostare le proprietà di base WebPart del controllo (ad esempio, SetIsClosed e SetHasSharedData).

Per gestire le connessioni, WebPartManagerInternals include i metodi per eliminarli (DeleteConnection), impostando quale oggetto trasformatore 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 utilizzare (SetConnectErrorMessage).

Metodi

Nome	Descrizione
AddWebPart(WebPart)	Aggiunge un WebPart controllo server o alla WebPartManager raccolta di WebPart controlli del controllo in una pagina Web.
CallOnClosing(WebPart)	Chiama il OnClosing(EventArgs) metodo del controllo specificato.
CallOnConnectModeChanged(WebPart)	Chiama il OnConnectModeChanged(EventArgs) metodo del controllo specificato.
CallOnDeleting(WebPart)	Chiama il OnDeleting(EventArgs) metodo del controllo specificato.
CallOnEditModeChanged(WebPart)	Chiama il OnEditModeChanged(EventArgs) metodo del controllo specificato.
ConnectionDeleted(WebPartConnection)	Indica se l'oggetto specificato WebPartConnection è stato eliminato.
CreateObjectFromType(Type)	Crea un oggetto basato sul 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 il Type dell'istanza corrente. (Ereditato da Object)
GetZoneID(WebPart)	Ottiene l'ID di una zona che contiene il controllo server o specificato WebPart .
LoadConfigurationState(WebPartTransformer, Object)	Carica i dati di stato salvati in precedenza per un WebPartTransformer oggetto che partecipa a una connessione tra i controlli.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
RemoveWebPart(WebPart)	Rimuove un WebPart controllo server o un altro dalla WebPartManager raccolta di controlli del controllo.
SaveConfigurationState(WebPartTransformer)	Salva i dati sullo stato per un WebPartTransformer oggetto che partecipa a una connessione tra i controlli.
SetConnectErrorMessage(WebPart, String)	Stabilisce un messaggio di errore e fa sì che l'oggetto WebPartChrome responsabile del rendering di un WebPart controllo esegua il rendering di tale messaggio anziché del contenuto del controllo.
SetHasSharedData(WebPart, Boolean)	Imposta una proprietà su un WebPart controllo server o su un altro oggetto che indica se il controllo dispone di dati di personalizzazione condivisi.
SetHasUserData(WebPart, Boolean)	Imposta una proprietà su un WebPart controllo server o su un altro controllo server che indica se il controllo dispone di dati di personalizzazione utente.
SetIsClosed(WebPart, Boolean)	Imposta la IsClosed proprietà di un WebPart controllo .
SetIsShared(WebPart, Boolean)	Imposta la IsShared proprietà di un WebPart controllo .
SetIsShared(WebPartConnection, Boolean)	Imposta la IsShared proprietà di un WebPartConnection oggetto .
SetIsStandalone(WebPart, Boolean)	Imposta la IsStandalone proprietà di un WebPart controllo .
SetIsStatic(WebPart, Boolean)	Imposta la IsStatic proprietà di un WebPart controllo .
SetIsStatic(WebPartConnection, Boolean)	Imposta la IsStatic proprietà di un WebPartConnection oggetto .
SetTransformer(WebPartConnection, WebPartTransformer)	Assegna un WebPartTransformer oggetto da utilizzare in una connessione tra due controlli server.
SetZoneID(WebPart, String)	Imposta una proprietà che consente a un WebPart controllo server o di mantenere l'ID della zona contenitore.
SetZoneIndex(WebPart, Int32)	Imposta l'indice del controllo specificato all'interno della relativa zona rispetto agli altri WebPart controlli all'interno della zona.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• WebPartManager
• controlli web part ASP.NET