WebPartManager.CreateErrorWebPart Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Skapar en särskild kontroll som infogas på en sida och visas för slutanvändare när ett försök att läsa in eller skapa en dynamisk WebPart kontroll av någon anledning misslyckas.
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 ErrorWebPartParametrar
- originalID
- String
En sträng som är ID för den misslyckade kontrollen. Om en GenericWebPart är inblandad i felet är ID:t för dess underordnade serverkontroll.
- originalTypeName
- String
En sträng som är namnet på den Type misslyckade kontrollen. Om en GenericWebPart är inblandad i felet är typnamnet typen av dess underordnade serverkontroll.
- originalPath
- String
En sträng som innehåller sökvägen till en användarkontroll, om en GenericWebPart som innehåller en underordnad användarkontroll är inblandad i felet.
- genericWebPartID
- String
En sträng som returnerar ID:t för en GenericWebPart, om den typen av kontroll var inblandad i att det inte gick att läsa in eller skapa en kontroll.
- errorMessage
- String
En sträng som innehåller felmeddelandet som ska visas på sidan.
Returer
En ErrorWebPart som infogas på en sida i stället för en kontroll som inte kunde läsas in eller skapas.
Kommentarer
Metoden CreateErrorWebPart anropas när kontrolluppsättningen webbdelar försöker läsa in eller skapa en instans av en dynamisk WebPart kontroll eller serverkontroll, och den misslyckas av någon anledning. Metoden skapar ett ErrorWebPart objekt, tilldelar ett felmeddelande till det och returnerar det. Kontrollen ErrorWebPart infogas i stället för kontrollen som misslyckades och dess felmeddelande visas på sidan.
Du kan inte anropa CreateErrorWebPart metoden direkt från koden. Du kan dock ärva från WebPartManager klassen och utöka metoden. Mer information finns i avsnittet Anteckningar för arvtagare.
Slutanvändarna kan arbeta med en ErrorWebPart kontroll på en sida ungefär som de skulle ha en normal WebPart kontroll. Om du vill ta bort felmeddelandet kan de stänga kontrollen genom att klicka på det nära verbet. Då läggs kontrollen till i ett PageCatalogPart objekt, precis som andra stängda kontroller. Om en slutanvändare tar bort en ErrorWebPart kontroll tas även serverkontrollen som inte kunde läsas in bort från sidan.
Anteckningar till arvingar
Om du vill anpassa den information som returneras i ErrorWebPart kontrollen kan du åsidosätta CreateErrorWebPart(String, String, String, String, String) metoden, anropa basmetoden, tilldela olika värden till de parametrar som skickas till basmetoden och sedan returnera den resulterande ErrorWebPart kontrollen. Om du till exempel inte vill att slutanvändarna originalPath ska se värdet (som visar sökvägen till den virtuella katalogen för en användarkontroll) kan du skicka en tom sträng ("") för den parametern när du anropar basmetoden.
Du kan också anpassa själva kontrollens ErrorWebPart beteende genom att ärva från den. Du kanske till exempel vill åsidosätta dess Title eller AllowMinimize egenskapen.
