WebPartManager.CreateErrorWebPart Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee maakt u een speciaal besturingselement dat wordt ingevoegd in een pagina en wordt weergegeven voor eindgebruikers, wanneer een poging om een dynamisch WebPart besturingselement te laden of te maken om een of andere reden mislukt.
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 ErrorWebPartParameters
- originalID
- String
Een tekenreeks die de id is van het mislukte besturingselement. Als er een GenericWebPart fout optreedt, is de id de id van het onderliggende serverbeheer.
- originalTypeName
- String
Een tekenreeks die de naam is van het Type besturingselement mislukt. Als er een GenericWebPart fout optreedt, is de typenaam het type van het onderliggende serverbeheer.
- originalPath
- String
Een tekenreeks die het pad naar een gebruikersbeheer bevat, als een GenericWebPart tekenreeks die een onderliggend gebruikersbeheer bevat, betrokken is bij de fout.
- genericWebPartID
- String
Een tekenreeks die de id van een GenericWebPartbesturingselement retourneert, als dat type besturingselement betrokken was bij het laden of maken van een besturingselement.
- errorMessage
- String
Een tekenreeks die het foutbericht bevat dat moet worden weergegeven op de pagina.
Retouren
Een ErrorWebPart besturingselement dat is ingevoegd in een pagina in plaats van een besturingselement dat niet kan worden geladen of gemaakt.
Opmerkingen
De CreateErrorWebPart methode wordt aangeroepen wanneer het besturingselement voor webonderdelen probeert een exemplaar van een dynamisch WebPart of serverbeheer te laden of te maken en dit om een of andere reden mislukt. De methode maakt een ErrorWebPart object, wijst er een foutbericht aan toe en retourneert het. Het ErrorWebPart besturingselement wordt ingevoegd in plaats van het besturingselement dat is mislukt en het bijbehorende foutbericht wordt weergegeven op de pagina.
U kunt de CreateErrorWebPart methode niet rechtstreeks vanuit uw code aanroepen. U kunt echter overnemen van de WebPartManager klasse en de methode uitbreiden. Zie de sectie Notities voor overnames voor meer informatie.
Eindgebruikers kunnen werken met een ErrorWebPart besturingselement op een pagina, net zoals ze een normaal WebPart besturingselement zouden hebben. Als u het foutbericht wilt verwijderen, kunnen ze het besturingselement sluiten door op het sluitwoord te klikken, waarna het besturingselement wordt toegevoegd aan een PageCatalogPart object, net als elk ander gesloten besturingselement. Als een eindgebruiker een ErrorWebPart besturingselement verwijdert, wordt het serverbeheer dat niet kan worden geladen ook van de pagina verwijderd.
Notities voor overnemers
Als u de informatie die wordt geretourneerd in het ErrorWebPart besturingselement wilt aanpassen, kunt u de CreateErrorWebPart(String, String, String, String, String) methode overschrijven, de basismethode aanroepen, verschillende waarden toewijzen aan de parameters die aan de basismethode worden doorgegeven en vervolgens het resulterende ErrorWebPart besturingselement retourneren. Als u bijvoorbeeld niet wilt dat eindgebruikers de originalPath waarde zien (waarmee het pad naar de virtuele map van een gebruikersbeheer wordt weergegeven), kunt u bij het aanroepen van de basismethode een lege tekenreeks ("") doorgeven voor die parameter.
U kunt ook het gedrag van het ErrorWebPart besturingselement zelf aanpassen door dit over te nemen. U wilt bijvoorbeeld de eigenschap of AllowMinimize eigenschap ervan overschrijvenTitle.