Sdílet prostřednictvím


WebPartManager.CreateErrorWebPart Metoda

Definice

Vytvoří speciální ovládací prvek, který se vloží na stránku a zobrazí se koncovým uživatelům, když pokus o načtení nebo vytvoření dynamického WebPart ovládacího prvku z nějakého důvodu selže.

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

Řetězec, který je ID neúspěšného ovládacího prvku. GenericWebPart Pokud se chyba týká nějakého objektu, id je ID jeho podřízeného ovládacího prvku serveru.

originalTypeName
String

Řetězec, který je názvem Type ovládacího prvku, který selhal. Pokud se selhání týká nějakého GenericWebPart typu, název typu je typem podřízeného serverového ovládacího prvku.

originalPath
String

Řetězec, který obsahuje cestu k uživatelskému ovládacímu prvku, pokud GenericWebPart je součástí selhání, který obsahuje podřízený uživatelský ovládací prvek.

genericWebPartID
String

Řetězec, který vrací ID GenericWebPart, pokud byl tento typ ovládacího prvku zapojen do selhání načtení nebo vytvoření ovládacího prvku.

errorMessage
String

Řetězec obsahující chybovou zprávu, která se má zobrazit na stránce.

Návraty

Vloží ErrorWebPart se na stránku místo ovládacího prvku, který se nepodařilo načíst nebo vytvořit.

Poznámky

Metoda CreateErrorWebPart je volána, když se sada ovládacích prvků webových částí pokusí načíst nebo vytvořit instanci dynamického WebPart nebo serverového ovládacího prvku a z nějakého důvodu selže. Metoda vytvoří ErrorWebPart objekt, přiřadí mu chybovou zprávu a vrátí ji. Ovládací ErrorWebPart prvek se vloží místo ovládacího prvku, který selhal, a na stránce se zobrazí jeho chybová zpráva.

Metodu CreateErrorWebPart nelze volat přímo z kódu. Můžete však dědit z WebPartManager třídy a rozšířit metodu. Podrobnosti najdete v části Poznámky pro dědíky.

Koncoví uživatelé můžou s ovládacím prvek na ErrorWebPart stránce pracovat podobně jako s normálním WebPart ovládacím prvku. Pokud chcete chybovou zprávu odebrat, můžou ovládací prvek zavřít kliknutím na příkaz zavřít. V tomto okamžiku bude ovládací prvek přidán do objektu PageCatalogPart , stejně jako jakýkoli jiný uzavřený ovládací prvek. Pokud koncový uživatel odstraní ovládací prvek ErrorWebPart , odstraní se ze stránky také serverový ovládací prvek, který se nepodařilo načíst.

Poznámky pro dědice

Pokud chcete přizpůsobit informace, které jsou vráceny v ovládacím ErrorWebPart prvku, můžete přepsat metodu CreateErrorWebPart(String, String, String, String, String) , volat základní metodu, přiřadit různé hodnoty parametrům předanými základní metodě a pak vrátit výsledný ErrorWebPart ovládací prvek. Pokud například nechcete, aby koncoví uživatelé viděli originalPath hodnotu (která by zobrazovala cestu k virtuálnímu adresáři uživatelského ovládacího prvku), můžete při volání základní metody předat prázdný řetězec ("") pro tento parametr.

Můžete také přizpůsobit chování samotného ErrorWebPart ovládacího prvku tak, že z něj zdědíte. Můžete například chtít přepsat jeho Title vlastnost nebo AllowMinimize .

Platí pro

Viz také