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 der Webpart-Steuerelementsatz versucht, eine Instanz eines dynamischen WebPart Steuerelements oder eines Serversteuerelements zu laden oder zu erstellen, und aus irgendeinem Grund fehlschlägt. Die -Methode erstellt ein ErrorWebPart -Objekt, weist ihm eine Fehlermeldung zu und gibt es zurück. Das ErrorWebPart Steuerelement wird anstelle des -Steuerelements eingefügt, bei dem ein Fehler aufgetreten ist, und seine Fehlermeldung wird auf der Seite angezeigt.

Sie können die CreateErrorWebPart Methode nicht direkt aus Ihrem Code aufrufen. Sie können jedoch von der -Klasse erben WebPartManager 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 ähnlich wie ein normales WebPart Steuerelement arbeiten. Um die Fehlermeldung zu entfernen, können sie das Steuerelement schließen, indem sie auf das Verb schließen 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 auch das Serversteuerelement, das nicht geladen werden konnte, von der Seite gelöscht.

Hinweise für Vererber

Wenn Sie die im Steuerelement zurückgegebenen Informationen anpassen möchten, können Sie die ErrorWebPart CreateErrorWebPart(String, String, String, String, String) -Methode überschreiben, die Basismethode aufrufen, den Parametern, die an die Basismethode übergeben werden, andere Werte zuweisen und dann das resultierende ErrorWebPart Steuerelement zurückgeben. Wenn Sie beispielsweise nicht möchten, dass Endbenutzer den Wert sehen (der den originalPath pfad des virtuellen Verzeichnisses eines Benutzersteuerelements anzeigt), können Sie beim Aufrufen der Basismethode eine leere Zeichenfolge ("") für diesen Parameter übergeben.

Sie können auch das Verhalten des ErrorWebPart Steuerelements selbst anpassen, indem Sie davon erben. Beispielsweise können Sie die eigenschaft Title oder AllowMinimize überschreiben.

Gilt für:

Freigeben über