WebPartManager.CreateErrorWebPart Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls.WebParts

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Crea un controllo speciale che viene inserito in una pagina e visualizzato per gli utenti finali, quando un tentativo di caricare o creare un controllo dinamico WebPart non riesce per qualche motivo.

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

Parametri

originalID: String

Stringa che rappresenta l'ID del controllo non riuscito. Se l'errore interessa un controllo GenericWebPart, l'ID è quello del relativo controllo server figlio.

originalTypeName: String

Stringa che rappresenta il nome dell'oggetto Type del controllo non riuscito. Se l'errore interessa un controllo GenericWebPart, il nome del tipo è il tipo del relativo controllo server figlio.

originalPath: String

Stringa contenente il percorso di un controllo utente, se l'errore interessa un controllo GenericWebPart che contiene un controllo utente figlio.

genericWebPartID: String

Stringa che restituisce l'ID di un controllo GenericWebPart, se tale tipo di controllo era coinvolto nell'errore di caricamento o creazione di un controllo.

errorMessage: String

Stringa che contiene il messaggio di errore da visualizzare nella pagina.

Restituisce

ErrorWebPart

Classe ErrorWebPart inserita in una pagina al posto di un controllo che non è stato possibile caricare o creare.

Commenti

Il CreateErrorWebPart metodo viene chiamato quando il set di controlli Web part tenta di caricare o creare un'istanza di un controllo dinamico WebPart o server e ha esito negativo per qualche motivo. Il metodo crea un ErrorWebPart oggetto, assegna un messaggio di errore e lo restituisce. Il ErrorWebPart controllo viene inserito al posto del controllo non riuscito e il messaggio di errore viene visualizzato nella pagina.

Non è possibile chiamare il CreateErrorWebPart metodo direttamente dal codice. Tuttavia, è possibile ereditare dalla WebPartManager classe ed estendere il metodo . Per informazioni dettagliate, vedere la sezione Note per gli eredi.

Gli utenti finali possono lavorare con un ErrorWebPart controllo in una pagina in modo molto simile a un WebPart normale controllo. Per rimuovere il messaggio di errore, è possibile chiudere il controllo facendo clic sul verbo di chiusura, a quel punto il controllo verrà aggiunto a un PageCatalogPart oggetto, come qualsiasi altro controllo chiuso. Se un utente finale elimina un ErrorWebPart controllo, anche il controllo server che non è riuscito a caricare verrà eliminato dalla pagina.

Note per gli eredi

Se si desidera personalizzare le informazioni restituite nel controllo, è possibile eseguire l'override del ErrorWebPart CreateErrorWebPart(String, String, String, String, String) metodo , chiamare il metodo di base, assegnare valori diversi ai parametri passati al metodo di base e quindi restituire il controllo risultante ErrorWebPart . Ad esempio, se non si vuole che gli utenti finali visualizzino il originalPath valore (che mostrerebbe il percorso della directory virtuale di un controllo utente), quando si chiama il metodo di base è possibile passare una stringa vuota ("") per tale parametro.

È anche possibile personalizzare il comportamento del ErrorWebPart controllo stesso, ereditando da esso. Ad esempio, è possibile eseguire l'override della relativa Title proprietà o AllowMinimize .

Si applica a