Condividi tramite


WebPartManager.CreateErrorWebPart Metodo

Definizione

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

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 non riesce per qualche motivo. Il metodo crea un ErrorWebPart oggetto, assegna un messaggio di errore a esso e lo restituisce. Il ErrorWebPart controllo viene inserito al posto del controllo che non è riuscito e il relativo 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 ereditatori.

Gli utenti finali possono usare un ErrorWebPart controllo in una pagina molto simile al normale WebPart 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, il controllo server che non è riuscito a caricare verrà eliminato anche dalla pagina.

Note per gli eredi

Se si desidera personalizzare le informazioni restituite nel ErrorWebPart controllo, è possibile eseguire l'override del metodo, chiamare il CreateErrorWebPart(String, String, String, String, String) 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 valore (che mostra il originalPath percorso della directory virtuale di un controllo utente), quando si chiama il metodo di base che è 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

Vedi anche