WebPartManager.CreateErrorWebPart Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls.WebParts

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Tworzy specjalną kontrolkę wstawioną do strony i wyświetlaną dla użytkowników końcowych, gdy próba załadowania lub utworzenia dynamicznej WebPart kontrolki kończy się niepowodzeniem z jakiegoś powodu.

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

Parametry

originalID: String

Ciąg, który jest identyfikatorem kontrolki, która kończy się niepowodzeniem. Jeśli element GenericWebPart jest zaangażowany w błąd, identyfikator jest identyfikatorem jego podrzędnej kontroli serwera.

originalTypeName: String

Ciąg, który jest nazwą kontrolki Type , która zakończyła się niepowodzeniem. Jeśli element GenericWebPart jest zaangażowany w błąd, nazwa typu jest typem jego podrzędnej kontroli serwera.

originalPath: String

Ciąg zawierający ścieżkę do kontrolki użytkownika, jeśli element GenericWebPart zawierający podrzędną kontrolkę użytkownika jest zaangażowany w błąd.

genericWebPartID: String

Ciąg, który zwraca identyfikator GenericWebPartobiektu , jeśli ten typ kontrolki był zaangażowany w błąd ładowania lub tworzenia kontrolki.

errorMessage: String

Ciąg zawierający komunikat o błędzie do wyświetlenia na stronie.

Zwraca

ErrorWebPart

Element ErrorWebPart wstawiony do strony zamiast kontrolki, która nie została załadowana lub utworzona.

Uwagi

Metoda jest wywoływana, gdy kontrolka CreateErrorWebPart składników Web Part próbuje załadować lub utworzyć wystąpienie kontrolki dynamicznej WebPart lub serwera i z jakiegoś powodu kończy się niepowodzeniem. Metoda tworzy ErrorWebPart obiekt, przypisuje do niego komunikat o błędzie i zwraca go. Kontrolka ErrorWebPart jest wstawiana zamiast kontrolki, która nie powiodła się, a na stronie jest wyświetlany komunikat o błędzie.

Nie można wywołać CreateErrorWebPart metody bezpośrednio z kodu. Można jednak dziedziczyć z WebPartManager klasy i rozszerzać metodę . Aby uzyskać szczegółowe informacje, zobacz sekcję Uwagi dotyczące dziedziczy.

Użytkownicy końcowi mogą pracować z kontrolką ErrorWebPart na stronie, podobnie jak w przypadku normalnej WebPart kontrolki. Aby usunąć komunikat o błędzie, mogą zamknąć kontrolkę, klikając czasownik zamknij, w którym momencie kontrolka zostanie dodana do PageCatalogPart obiektu, podobnie jak każda inna zamknięta kontrolka. Jeśli użytkownik końcowy usunie kontrolkę ErrorWebPart , kontrolka serwera, która nie mogła załadować, również zostanie usunięta ze strony.

Uwagi dotyczące dziedziczenia

Jeśli chcesz dostosować informacje zwracane w kontrolce ErrorWebPart , możesz zastąpić CreateErrorWebPart(String, String, String, String, String) metodę , wywołać metodę bazową, przypisać różne wartości do parametrów przekazanych do metody podstawowej, a następnie zwrócić wynikową ErrorWebPart kontrolkę. Jeśli na przykład nie chcesz, aby użytkownicy końcowi widzieli originalPath wartość (co spowoduje wyświetlenie ścieżki katalogu wirtualnego kontrolki użytkownika), podczas wywoływania metody podstawowej można przekazać pusty ciąg ("") dla tego parametru.

Możesz również dostosować zachowanie samej kontrolki ErrorWebPart , dziedzicując po niej. Możesz na przykład zastąpić jego Title właściwość lub AllowMinimize .

Dotyczy

Udostępnij za pośrednictwem