WebPartManager.CreateErrorWebPart Methode
Definition
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 in eine Seite eingefügt und für Endbenutzer angezeigt wird, wenn ein Versuch, ein dynamisches WebPart Steuerelement zu laden oder zu erstellen, aus irgendeinem Grund fehlschlägt.
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.ErrorWebPartProtected Overridable Function CreateErrorWebPart (originalID As String, originalTypeName As String, originalPath As String, genericWebPartID As String, errorMessage As String) As ErrorWebPartParameter
- originalID
- String
Eine Zeichenfolge, die die ID des fehlerhaften Steuerelements ist. Wenn ein GenericWebPart Fehler auftritt, ist die ID die ID des untergeordneten Serversteuerelements.
- originalTypeName
- String
Eine Zeichenfolge, die Type den Namen des fehlgeschlagenen Steuerelements darstellt. Wenn ein GenericWebPart Fehler auftritt, ist der Typname der Typ des untergeordneten Serversteuerelements.
- originalPath
- String
Eine Zeichenfolge, die den Pfad zu einem Benutzersteuerelement enthält, wenn ein GenericWebPart Element, das ein untergeordnetes Benutzersteuerelement enthält, an dem Fehler beteiligt ist.
- genericWebPartID
- String
Eine Zeichenfolge, die die ID eines GenericWebPartSteuerelements zurückgibt, wenn dieser Typ des Steuerelements an dem Fehler beim Laden oder Erstellen eines Steuerelements beteiligt war.
- errorMessage
- String
Eine Zeichenfolge, die die Fehlermeldung enthält, die auf der Seite angezeigt werden soll.
Gibt zurück
Ein ErrorWebPart Steuerelement, das anstelle eines Steuerelements in eine Seite eingefügt wird, das nicht geladen oder erstellt werden konnte.
Hinweise
Die CreateErrorWebPart Methode wird aufgerufen, wenn das Webpart-Steuerelement versucht, eine Instanz eines dynamischen WebPart oder 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 fehlgeschlagenen Steuerelements eingefügt, und seine Fehlermeldung wird auf der Seite angezeigt.
Sie können die CreateErrorWebPart Methode nicht direkt aus Dem 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 Vererbungen".
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 schließende Verb klicken, an dem das Steuerelement einem PageCatalogPart Objekt wie jedem anderen geschlossenen Steuerelement hinzugefügt wird. 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 informationen anpassen möchten, die im ErrorWebPart Steuerelement zurückgegeben werden, können Sie die CreateErrorWebPart(String, String, String, String, String) Methode überschreiben, die Basismethode aufrufen, den Parametern, die an die Basismethode übergeben werden, unterschiedliche 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. Sie können z. B. deren Title Eigenschaft AllowMinimize oder Eigenschaft überschreiben.
