ExceptionMessageBox Classe

Définition

Espace de noms:

Microsoft.SqlServer.MessageBox

Assembly:

Microsoft.ExceptionMessageBox.dll

Affiche une boîte de message personnalisable avec du texte, des boutons et des symboles pour améliorer l’expérience client avec une application basée sur Microsoft Windows .NET Framework.

public ref class ExceptionMessageBox

[System.Runtime.InteropServices.ComVisible(false)]
public class ExceptionMessageBox

[<System.Runtime.InteropServices.ComVisible(false)>]
type ExceptionMessageBox = class

Public Class ExceptionMessageBox

Héritage

Object

ExceptionMessageBox

Attributs

ComVisibleAttribute

Exemples

Cet exemple affiche la boîte de message avec un bouton OK .

try
{
    // Do something that may generate an exception.
    throw new ApplicationException("An error has occured");
}
catch (ApplicationException ex)
{
    // Define a new top-level error message.
    string str = "The action failed.";

    // Add the new top-level message to the handled exception.
    ApplicationException exTop = new ApplicationException(str, ex);
    exTop.Source = this.Text;

    // Show an exception message box with an OK button (the default).
    ExceptionMessageBox box = new ExceptionMessageBox(exTop);
    box.Show(this);
}

Try
    ' Do something that may generate an exception.
    Throw New ApplicationException("An error has occured")
Catch ex As ApplicationException
    ' Define a new top-level error message.
    Dim str As String = "The action failed."

    ' Add the new top-level message to the handled exception.
    Dim exTop As ApplicationException = New ApplicationException(str, ex)
    exTop.Source = Me.Text

    ' Show an exception message box with an OK button (the default).
    Dim box As ExceptionMessageBox = New ExceptionMessageBox(exTop)
    box.Show(Me)
End Try

Cet exemple utilise la boîte de message d’exception pour afficher des informations supplémentaires utiles lors du dépannage ou du débogage.

try
{
    // Do something that you don't expect to generate an exception.
    throw new ApplicationException("Failed to connect to the server.");
}
catch (ApplicationException ex)
{
    string str = "An unexpected error occurred. Please call Helpdesk.";
    ApplicationException exTop = new ApplicationException(str, ex);
    exTop.Source = this.Text;

    // Information in the Data property of an exception that has a name
    // beginning with "HelpLink.Advanced" is shown when the user
    // clicks the Advanced Information button of the exception message
    // box dialog box.
    exTop.Data.Add("AdvancedInformation.FileName", "application.dll");
    exTop.Data.Add("AdvancedInformation.FilePosition", "line 355");
    exTop.Data.Add("AdvancedInformation.UserContext", "single user mode");

    // Show the exception message box with additional information that 
    // is helpful when a user calls technical support.
    ExceptionMessageBox box = new ExceptionMessageBox(exTop);

    box.Show(this);
}

Try
    ' Do something that you don't expect to generate an exception.
    Throw New ApplicationException("Failed to connect to the server.")
Catch ex As ApplicationException
    Dim str As String = "An unexpected error occurred. Please call Helpdesk."
    Dim exTop As ApplicationException = New ApplicationException(str, ex)
    exTop.Source = Me.Text

    ' Information in the Data property of an exception that has a name
    ' beginning with "HelpLink.Advanced" is shown when the user
    ' clicks the Advanced Information button of the exception message
    ' box dialog box.
    exTop.Data.Add("AdvancedInformation.FileName", "application.dll")
    exTop.Data.Add("AdvancedInformation.FilePosition", "line 355")
    exTop.Data.Add("AdvancedInformation.UserContext", "single user mode")

    ' Show the exception message box with additional information that 
    ' is helpful when a user calls technical support.
    Dim box As ExceptionMessageBox = New ExceptionMessageBox(exTop)

    box.Show(Me)

End Try

Constructeurs

Nom	Description
ExceptionMessageBox()	Crée une instance de ExceptionMessageBox avec les propriétés par défaut.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Crée une instance de ExceptionMessageBox en utilisant les informations du fichier spécifié Exception et en spécifiant les boutons, le symbole, le bouton par défaut et d’autres propriétés à afficher dans la boîte de message d’exception.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Crée une instance de ExceptionMessageBox en utilisant les informations du spécifié Exception et en spécifiant les boutons, le symbole et le bouton par défaut à afficher dans la boîte de message d’exception. .
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Crée une instance de ExceptionMessageBox en utilisant les informations du spécifié Exception et en spécifiant les boutons et le symbole à afficher dans la boîte de message.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Crée une instance de ExceptionMessageBox en utilisant les informations du fichier spécifié Exception et en spécifiant les boutons à afficher dans la boîte de message.
ExceptionMessageBox(Exception)	Crée une instance de ExceptionMessageBox en utilisant des informations issues du fichier spécifié Exception.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Crée une instance de ExceptionMessageBox avec le texte de message d’erreur de premier niveau fourni et la légende de la boîte de dialogue de la boîte de message. La méthode spécifie également les boutons, symboles, boutons par défaut et options de dialogue à afficher dans la boîte de message d’exception.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Crée une instance de ExceptionMessageBox avec le texte de message d’erreur de premier niveau fourni et la légende de la boîte de dialogue de la boîte de message. La méthode spécifie également les boutons, le symbole et le bouton par défaut à afficher dans la boîte de message d’exception.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Crée une instance de ExceptionMessageBox avec le texte du message d’erreur de premier niveau fourni et la légende de la boîte de dialogue de la boîte de message d’exception. La méthode spécifie également les boutons et le symbole à afficher dans la boîte de message d’exception.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Crée une instance de ExceptionMessageBox avec le texte du message d’erreur de premier niveau fourni et la légende de la boîte de dialogue de la boîte d’exception. La méthode spécifie également des boutons à afficher dans la boîte de message d’exception.
ExceptionMessageBox(String, String)	Crée une instance de ExceptionMessageBox avec le texte du message d’erreur de premier niveau fourni et la légende de la boîte de dialogue de la boîte d’exception.
ExceptionMessageBox(String)	Crée une instance de ExceptionMessageBox avec le message d’erreur de premier niveau fourni.

Propriétés

Nom	Description
AbortButtonText	Il obtient le texte par défaut pour le bouton Annuler .
Beep	Précise s’il faut jouer un son audible lors de l’affichage du message.
Buttons	Obtient ou règle les boutons pour qu’ils s’affichent dans la boîte de message.
CancelButtonText	Il obtient le texte par défaut pour le bouton Annuler .
Caption	Obtient ou définit la légende de la boîte de dialogue de la boîte d’exception.
CheckBoxRegistryKey	Définit un ouvert RegistryKey qui contrôle la case à cocher affichée sur la boîte de message d’exception lorsque ShowCheckBox est true.
CheckBoxRegistryMeansDoNotShowDialog	Détermine si le registre valorise le contenu spécifié par CheckBoxRegistryKey et CheckBoxRegistryValue indique une décision antérieure de l’utilisateur de ne pas consulter ce message.
CheckBoxRegistryValue	Obtient ou définit le nom de valeur du registre qui contrôle la case à cocher sur la boîte de message d’exception lorsque ShowCheckBox est true.
CheckBoxText	Obtient ou configure le texte pour qu’il affiche dans la case à cocher de la boîte de message d’exception lorsque ShowCheckBox est true.
CustomDialogResult	On obtient le bouton de dialogue texte personnalisé cliqué.
CustomSymbol	Obtient ou définit un bitmap personnalisé à utiliser comme symbole sur la boîte de message d’exception.
Data	Obtient l’interface IDictionary qui stocke le lien d’aide et les informations avancées associées au message de premier niveau.
DefaultButton	Obtient ou règle le bouton par défaut dans la boîte de message.
DefaultDialogResult	Obtient ou définit la valeur retournée par la Show(IWin32Window) méthode lorsque l’utilisateur a précédemment indiqué de ne plus afficher un message donné.
FailButtonText	Il obtient le texte par défaut pour le bouton Échec .
Font	Obtient ou définit la police utilisée dans la boîte de message.
HelpLink	Obtient ou place le lien vers le fichier d’aide ou la page Web d’aide associée au message de premier niveau.
IgnoreButtonText	Obtient le texte par défaut pour le bouton Ignorer .
InnerException	Obtient ou définit l’instance Exception associée au(s) message(s) de niveau inférieur.
IsCheckBoxChecked	Précise si la case à cocher est cochée lorsque ShowCheckBox est true.
Message	Obtient ou définit le Exception qui contient le message à afficher.
MessageLevelDefault	Obtient ou définit le nombre de niveaux de message à afficher dans la boîte de message.
NoButtonText	Ça obtient le texte par défaut pour le bouton Non
OKButtonText	Ça obtient le texte par défaut pour le bouton OK
Options	Obtient ou définit diverses options d’affichage pour la boîte de message
RetryButtonText	Il obtient le texte par défaut pour le bouton Réessayer .
ShowCheckBox	Précise s’il faut afficher la case à cocher dans la boîte de message d’exception.
ShowToolBar	Précise s’il faut afficher la barre d’outils du bouton de commande dans la boîte de message d’exception.
Symbol	Obtient ou définit le symbole pour qu’il s’affiche dans la boîte de message d’exception.
Text	Obtient ou définit le texte du message de premier niveau pour qu’il s’affiche dans la boîte de message d’exception
UseOwnerFont	Précise s’il faut récupérer la police de la fenêtre propriétaire et l’utiliser comme police pour la boîte de message d’exception.
YesButtonText	Obtient le texte par défaut pour le bouton Oui

Méthodes

Nom	Description
GetMessageText(Exception)	Retourne la chaîne qu’un utilisateur peut copier dans le presse-papiers lorsque l’exception est affichée dans une boîte de message d’exception.
SetButtonText(String, String, String, String, String)	Définit le texte des boutons de texte personnalisés lorsque seuls cinq boutons sont affichés dans la boîte de message d’exception.
SetButtonText(String, String, String, String)	Définit le texte des boutons de texte personnalisés lorsque seuls quatre boutons sont affichés dans la boîte de message d’exception.
SetButtonText(String, String, String)	Définit le texte des boutons de texte personnalisés lorsque seuls trois boutons sont affichés dans la boîte de message d’exception.
SetButtonText(String, String)	Définit le texte des boutons de texte personnalisés lorsque seuls deux boutons sont affichés dans la boîte de message d’exception.
SetButtonText(String)	Définit le texte pour le bouton texte personnalisé lorsqu’un seul bouton est affiché dans la boîte de message d’exception.
Show(IntPtr, String, String, String, String, String, String, String)	Affiche la boîte de message d’exception. Identifié à titre d'information uniquement. Non prise en charge. La compatibilité future n'est pas garantie.
Show(IWin32Window)	Affiche la boîte de message d’exception comme une boîte de dialogue modale centrée sur la fenêtre parente.

Événements

Nom	Description
OnCopyToClipboard	Se produit lorsque le texte du message d’exception est copié de la boîte de message vers le presse-papier.