WebPartManagerInternals Klasse

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Isoliert Methoden, die vom WebPartManager-Steuerelement verwendet werden und von Entwicklern, die das Steuerelement erweitern, überschrieben werden können, jedoch nur selten von Seitenentwicklern benötigt werden, in einer separaten Klasse.

public ref class WebPartManagerInternals sealed

public sealed class WebPartManagerInternals

type WebPartManagerInternals = class

Public NotInheritable Class WebPartManagerInternals

Vererbung

Object

WebPartManagerInternals

Hinweise

Die WebPartManager -Klasse ist die größte Klasse im Webparts-Steuerelementsatz. Es gehört auch zu den wichtigsten Webparts-Klassen, da es auf jeder Webseite verwendet wird, die Webparts-Steuerelemente enthält, und alle Webparts-Steuerelemente auf einer Seite koordiniert und verwaltet.

Da die WebPartManager -Klasse so häufig verwendet wird und so viele verfügbar gemachte Methoden enthält, sind einige Methoden, die hauptsächlich von Steuerelemententwicklern benötigt werden, die das WebPartManager Steuerelement erweitern, in der WebPartManagerInternals -Klasse enthalten. Diese Isolation von weniger verwendeten Methoden in die WebPartManagerInternals -Klasse vereinfacht die API der WebPartManager -Klasse, und die isolierten Methoden werden nicht im WebPartManager -Objekt in IntelliSense angezeigt.

Entwickler, die die WebPartManagerInternals -Klasse verwenden, haben wahrscheinlich Szenarien, in denen sie vom WebPartManager Steuerelement erben und es umfassend anpassen müssen. Wenn Sie beispielsweise eine Webportalanwendung oder eine gepackte Gruppe von Webparts-Steuerelementen mit benutzerdefinierten Anzeigemodi, benutzerdefinierten Zonen, benutzerdefinierten Verben, benutzerdefinierten WebPart Steuerelementen und anderen Erweiterungen der Basis-Webparts-Benutzeroberfläche (UI) erstellen, müssen Sie in vielen Fällen (nicht alle) einige der WebPartManager Member außer Kraft setzen und erweitern. Und obwohl die WebPartManagerInternals Klasse versiegelt ist, sodass Sie nicht von ihr erben können, muss Ihre benutzerdefinierte WebPartManager Klasse wahrscheinlich eine Reihe der WebPartManagerInternals Methoden aufrufen, um Webparts-Steuerelemente auf einer Seite zu verwalten.

Hinweis

Wie die WebPartManager -Klasse stellt die WebPartManagerInternals -Klasse ein Serversteuerelement bereit, das über keine Benutzeroberfläche verfügt und nie auf einer Seite sichtbar ist. Im Gegensatz zu WebPartManagerwird die WebPartManagerInternals -Klasse nie im Markup einer Seite deklariert. Es handelt sich ausschließlich um ein Workerobjekt, das Hintergrundaufgaben ausführt. Die typische Verwendungsart wird durch die WebPartManager -Klasse veranschaulicht, die mithilfe der geschützten Internals Eigenschaft darauf verweist und das objekt verwendet, auf das verwiesen wird, um die WebPartManagerInternals Methoden aufzurufen.

Die WebPartManagerInternals -Klasse enthält nur Methoden. Es gibt keine Eigenschaften oder Ereignisse. Alle Methoden in der -Klasse umfassen die Verwaltung von WebPart Steuerelementen oder Verbindungen zwischen Steuerelementen.

Um Steuerelemente zu behandeln WebPart , WebPartManagerInternals umfasst Methoden zum Hinzufügen (AddWebPart), Entfernen , RemoveWebPartBehandeln von Ereignissen CallOnDeleting), Abrufen oder Festlegen von Details über deren Beziehung zu ihrer Zone (z. B. GetZoneID und SetZoneIndex) oder Festlegen grundlegender WebPart Steuerelementeigenschaften (z. B SetIsClosed . und SetHasSharedData).

Um Verbindungen zu behandeln, WebPartManagerInternals umfasst Methoden zum Löschen (DeleteConnection), Festlegen des zu verwendenden Transformatorobjekts (SetTransformer), Festlegen, ob eine Verbindung freigegeben wird und ob sie statisch ist (SetIsShared(WebPartConnection, Boolean) und SetIsStatic(WebPartConnection, Boolean)), und Festlegen einer Verbindungsfehlermeldung für die Verwendung (SetConnectErrorMessage).

Methoden

AddWebPart(WebPart)	Fügt der Auflistung von WebPart-Steuerelementen für das WebPartManager-Steuerelement ein WebPart-Steuerelement oder ein Serversteuerelement auf einer Webseite hinzu.
CallOnClosing(WebPart)	Ruft die OnClosing(EventArgs)-Methode des angegebenen Steuerelements auf.
CallOnConnectModeChanged(WebPart)	Ruft die OnConnectModeChanged(EventArgs)-Methode des angegebenen Steuerelements auf.
CallOnDeleting(WebPart)	Ruft die OnDeleting(EventArgs)-Methode des angegebenen Steuerelements auf.
CallOnEditModeChanged(WebPart)	Ruft die OnEditModeChanged(EventArgs)-Methode des angegebenen Steuerelements auf.
ConnectionDeleted(WebPartConnection)	Gibt an, ob das angegebene WebPartConnection-Objekt gelöscht wurde.
CreateObjectFromType(Type)	Erstellt ein Objekt auf der Grundlage des Parameters, der an die Methode übergeben wird.
DeleteConnection(WebPartConnection)	Legt eine Eigenschaft fest, um anzugeben, dass das angegebene Verbindungsobjekt gelöscht wurde.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetZoneID(WebPart)	Ruft die ID einer Zone ab, die das angegebene WebPart-Steuerelement oder das Serversteuerelement enthält.
LoadConfigurationState(WebPartTransformer, Object)	Lädt zuvor gespeicherte Zustandsdaten für ein WebPartTransformer-Objekt, das an einer Verbindung zwischen Steuerelementen teilnimmt.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
RemoveWebPart(WebPart)	Entfernt ein WebPart-Steuerelement oder ein anderes Serversteuerelement aus der Steuerelementauflistung für das WebPartManager-Steuerelement.
SaveConfigurationState(WebPartTransformer)	Speichert Zustandsdaten für ein WebPartTransformer-Objekt, das an einer Verbindung zwischen Steuerelementen teilnimmt.
SetConnectErrorMessage(WebPart, String)	Erstellt eine Fehlermeldung und bewirkt, dass von dem für das Rendern eines WebPartChrome-Steuerelements zuständigen WebPart-Objekts anstelle des Inhalts des Steuerelements diese Fehlermeldung gerendert wird.
SetHasSharedData(WebPart, Boolean)	Legt eine Eigenschaft für ein WebPart-Steuerelement oder ein anderes Serversteuerelement fest, die angibt, ob das Steuerelement über freigegebene Personalisierungsdaten verfügt.
SetHasUserData(WebPart, Boolean)	Legt eine Eigenschaft für ein WebPart-Steuerelement oder ein anderes Serversteuerelement fest, die angibt, ob das Steuerelement über Benutzerpersonalisierungsdaten verfügt.
SetIsClosed(WebPart, Boolean)	Legt die IsClosed-Eigenschaft eines WebPart-Steuerelements fest.
SetIsShared(WebPart, Boolean)	Legt die IsShared-Eigenschaft eines WebPart-Steuerelements fest.
SetIsShared(WebPartConnection, Boolean)	Legt die IsShared-Eigenschaft eines WebPartConnection-Objekts fest.
SetIsStandalone(WebPart, Boolean)	Legt die IsStandalone-Eigenschaft eines WebPart-Steuerelements fest.
SetIsStatic(WebPart, Boolean)	Legt die IsStatic-Eigenschaft eines WebPart-Steuerelements fest.
SetIsStatic(WebPartConnection, Boolean)	Legt die IsStatic-Eigenschaft eines WebPartConnection-Objekts fest.
SetTransformer(WebPartConnection, WebPartTransformer)	Weist ein WebPartTransformer-Objekt zu, das für eine Verbindung zwischen zwei Serversteuerelementen verwendet werden soll.
SetZoneID(WebPart, String)	Legt eine Eigenschaft fest, mit deren Hilfe ein WebPart-Steuerelement oder ein Serversteuerelement die ID der Zone, in der es enthalten ist, beibehalten kann.
SetZoneIndex(WebPart, Int32)	Legt den Index des angegebenen Steuerelements in der Zone relativ zu den anderen WebPart-Steuerelementen in der Zone fest.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• WebPartManager
• ASP.NET Webparts-Steuerelemente