WebPartManager.CreateErrorWebPart Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vytvoří speciální ovládací prvek, který se vloží na stránku a zobrazí se koncovým uživatelům, když se z nějakého důvodu pokusí načíst nebo vytvořit dynamický WebPart ovládací prvek.
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 ErrorWebPartParametry
- originalID
- String
Řetězec, který je ID ovládacího prvku způsobujícího selhání. GenericWebPart Pokud se selhání týká, ID je ID jeho podřízeného serveru řízení.
- originalTypeName
- String
Řetězec, který je názvem Type ovládacího prvku, který selhal. GenericWebPart Pokud se selhání týká, název typu je typ jeho podřízeného serveru řízení.
- originalPath
- String
Řetězec, který obsahuje cestu k uživatelskému ovládacímu prvku, pokud je selhání zapojeno GenericWebPart do podřízeného uživatelského ovládacího prvku.
- genericWebPartID
- String
Řetězec, který vrací ID ovládacího GenericWebPartprvku , 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žený ErrorWebPart 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 při pokusu o načtení nebo vytvoření instance dynamického WebPart nebo serverového ovládacího prvku webové části 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 jeho chybová zpráva se zobrazí na stránce.
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ědiče.
Koncoví uživatelé můžou pracovat s ovládacím ErrorWebPart prvku na stránce podobně jako normální WebPart ovládací prvek. Pokud chcete chybovou zprávu odebrat, mohou ovládací prvek zavřít kliknutím na příkaz zavřít, v jakém 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í ErrorWebPart ovládací prvek, odstraní se ze stránky také ovládací prvek serveru, který se nepodařilo načíst.
Poznámky pro dědice
Pokud chcete přizpůsobit informace vrácené v ovládacím ErrorWebPart prvku, můžete přepsat CreateErrorWebPart(String, String, String, String, String) metodu, 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), při volání základní metody byste pro tento parametr mohli předat prázdný řetězec ("").
Chování samotného ErrorWebPart ovládacího prvku můžete také přizpůsobit tak, že z něj dědíte. Můžete například chtít přepsat jeho Title nebo AllowMinimize vlastnost.
