Partager via


WebPartManager.CreateErrorWebPart Méthode

Définition

Crée un contrôle spécial qui est inséré dans une page et affiché à l'attention des utilisateurs finaux lorsqu'une tentative de chargement ou de création d'un contrôle WebPart dynamique échoue pour une raison quelconque.

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

Paramètres

originalID
String

Chaîne qui constitue l'ID du contrôle défaillant. Si un GenericWebPart est impliqué dans la défaillance, l'ID correspond à l'ID de son contrôle serveur enfant.

originalTypeName
String

Chaîne qui définit le nom du Type du contrôle défaillant. Si un GenericWebPart est impliqué dans la défaillance, le nom de type correspond au type de son contrôle serveur enfant.

originalPath
String

Chaîne qui contient le chemin d'accès à un contrôle utilisateur si un GenericWebPart qui contient un contrôle utilisateur enfant est impliqué dans la défaillance.

genericWebPartID
String

Chaîne qui retourne l'ID d'un GenericWebPart si ce type de contrôle était impliqué dans l'échec de chargement ou de création d'un contrôle.

errorMessage
String

Chaîne qui contient le message d'erreur à afficher sur la page.

Retours

ErrorWebPart inséré dans une page à la place d'un contrôle dont le chargement ou la création a échoué.

Remarques

La CreateErrorWebPart méthode est appelée lorsque le jeu de contrôles WebPart tente de charger ou de créer une instance d’un contrôle dynamique WebPart ou serveur, et qu’elle échoue pour une raison quelconque. La méthode crée un ErrorWebPart objet, lui attribue un message d’erreur et le retourne. Le ErrorWebPart contrôle est inséré à la place du contrôle qui a échoué et son message d’erreur s’affiche sur la page.

Vous ne pouvez pas appeler la CreateErrorWebPart méthode directement à partir de votre code. Toutefois, vous pouvez hériter de la WebPartManager classe et étendre la méthode . Pour plus d’informations, consultez la section Remarques pour les héritiers.

Les utilisateurs finaux peuvent utiliser un ErrorWebPart contrôle dans une page comme ils le feraient pour un contrôle normal WebPart . Pour supprimer le message d’erreur, ils peuvent fermer le contrôle en cliquant sur le verbe fermer, auquel cas le contrôle sera ajouté à un PageCatalogPart objet, comme tout autre contrôle fermé. Si un utilisateur final supprime un ErrorWebPart contrôle, le contrôle serveur qui n’a pas pu être chargé est également supprimé de la page.

Notes pour les héritiers

Si vous souhaitez personnaliser les informations retournées dans le ErrorWebPart contrôle, vous pouvez remplacer la méthode, appeler la CreateErrorWebPart(String, String, String, String, String) méthode de base, affecter différentes valeurs aux paramètres passés à la méthode de base, puis retourner le contrôle résultant ErrorWebPart . Par exemple, si vous ne souhaitez pas que les utilisateurs finaux voient la originalPath valeur (qui affiche le chemin d’accès du répertoire virtuel d’un contrôle utilisateur), lorsque vous appelez la méthode de base, vous pouvez passer une chaîne vide («  ») pour ce paramètre.

Vous pouvez également personnaliser le comportement du ErrorWebPart contrôle lui-même, en héritant de celui-ci. Par exemple, vous souhaiterez peut-être remplacer sa Title propriété ou AllowMinimize .

S’applique à

Voir aussi