WebPartManager.CreateErrorWebPart Methode

Referenz

Definition

Namespace:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Erstellt ein spezielles Steuerelement, das auf eine Seite eingefügt wird und das für Endbenutzer angezeigt wird, wenn der Versuch fehlschlägt, ein dynamisches WebPart-Steuerelement zu laden oder zu erstellen.

protected:
 virtual System::Web::UI::WebControls::WebParts::ErrorWebPart ^ CreateErrorWebPart(System::String ^ originalID, System::String ^ originalTypeName, System::String ^ originalPath, System::String ^ genericWebPartID, System::String ^ errorMessage);

protected virtual System.Web.UI.WebControls.WebParts.ErrorWebPart CreateErrorWebPart (string originalID, string originalTypeName, string originalPath, string genericWebPartID, string errorMessage);

abstract member CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart
override this.CreateErrorWebPart : string * string * string * string * string -> System.Web.UI.WebControls.WebParts.ErrorWebPart

Protected Overridable Function CreateErrorWebPart (originalID As String, originalTypeName As String, originalPath As String, genericWebPartID As String, errorMessage As String) As ErrorWebPart

Parameter

originalID: String

Eine Zeichenfolge, die die ID des Steuerelements darstellt, bei dem der Fehler aufgetreten ist. Wenn GenericWebPart am Fehler beteiligt ist, entspricht die ID der ID von dessen untergeordneten Serversteuerelement.

originalTypeName: String

Eine Zeichenfolge, die den Namen des Type des Steuerelements darstellt, bei dem der Fehler aufgetreten ist. Wenn GenericWebPart am Fehler beteiligt ist, entspricht der Typname dem Typ von dessen untergeordneten Serversteuerelement.

originalPath: String

Eine Zeichenfolge, die den Pfad zu einem Benutzersteuerelement enthält, wenn ein GenericWebPart mit einem ungeordneten Benutzersteuerelement am Fehler beteiligt ist.

genericWebPartID: String

Eine Zeichenfolge, die die ID eines GenericWebPart zurückgibt, wenn dieser Steuerelementtyp am Fehler beim Laden oder Erstellen eines Steuerelements beteiligt war.

errorMessage: String

Eine Zeichenfolge, die die Fehlermeldung enthält, die auf der Seite angezeigt wird.

Gibt zurück

ErrorWebPart

Ein ErrorWebPart, der auf einer Seite anstelle eines Steuerelements eingefügt wird, bei dem ein Fehler beim Laden oder Erstellen aufgetreten ist.

Hinweise

Die CreateErrorWebPart Methode wird aufgerufen, wenn das Webparts-Steuerelement versucht, eine Instanz eines dynamischen WebPart oder Serversteuerelements zu laden oder zu erstellen, und es schlägt aus irgendeinem Grund fehl. Die Methode erstellt ein ErrorWebPart Objekt, weist ihm eine Fehlermeldung zu und gibt es zurück. Das ErrorWebPart Steuerelement wird anstelle des fehlgeschlagenen Steuerelements eingefügt, und die Fehlermeldung wird auf der Seite angezeigt.

Sie können die CreateErrorWebPart Methode nicht direkt aus Ihrem Code aufrufen. Sie können jedoch von der WebPartManager Klasse erben und die Methode erweitern. Ausführliche Informationen finden Sie im Abschnitt "Hinweise für Erben".

Endbenutzer können mit einem ErrorWebPart Steuerelement auf einer Seite wie ein normales WebPart Steuerelement arbeiten. Um die Fehlermeldung zu entfernen, können sie das Steuerelement schließen, indem sie auf das schließende Verb klicken, an dem das Steuerelement einem PageCatalogPart Objekt hinzugefügt wird, wie jedes andere geschlossene Steuerelement. Wenn ein Endbenutzer ein ErrorWebPart Steuerelement löscht, wird das Serversteuerelement, das nicht geladen werden konnte, auch von der Seite gelöscht.

Hinweise für Vererber

Wenn Sie die informationen anpassen möchten, die im ErrorWebPart Steuerelement zurückgegeben werden, können Sie die CreateErrorWebPart(String, String, String, String, String) Methode außer Kraft setzen, die Basismethode aufrufen, den Parametern, die an die Basismethode übergeben werden, verschiedene Werte zuweisen und dann das resultierende ErrorWebPart Steuerelement zurückgeben. Wenn Endbenutzer beispielsweise nicht möchten, dass der originalPath Wert angezeigt wird (der den virtuellen Verzeichnispfad eines Benutzersteuerelements anzeigt), wenn Sie die Basismethode aufrufen, könnten Sie eine leere Zeichenfolge ("") für diesen Parameter übergeben.

Sie können auch das Verhalten des ErrorWebPart Steuerelements selbst anpassen, indem Sie es erben. Beispielsweise können Sie die Title Eigenschaft außer AllowMinimize Kraft setzen.

Gilt für