ExceptionMessageBox Classe

Référence

Définition

Espace de noms:: Microsoft.SqlServer.MessageBox

Assembly:: Microsoft.ExceptionMessageBox.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Affiche une boîte de message qui peut être personnalisée 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 montre comment afficher 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 d'un dépannage ou d'un 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

ExceptionMessageBox()	Crée une instance de ExceptionMessageBox avec les propriétés par défaut.
ExceptionMessageBox(Exception)	Crée une instance de ExceptionMessageBox à l'aide des informations du Exception spécifié.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Crée une instance de ExceptionMessageBox à l'aide des informations du Exception spécifié et en indiquant les boutons à afficher dans la boîte de message.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Crée une instance de ExceptionMessageBox à l'aide des informations du Exception spécifié et en indiquant les boutons et le symbole à afficher dans la boîte de message.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Crée une instance de ExceptionMessageBox à l'aide des informations du Exception spécifié et en indiquant les boutons, le symbole et le bouton par défaut à afficher dans la boîte de message d'exception. .
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Crée une instance de ExceptionMessageBox à l'aide des informations du Exception spécifié et en indiquant 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(String)	Crée une instance de ExceptionMessageBox avec le texte du message d'erreur de niveau supérieur fourni.
ExceptionMessageBox(String, String)	Crée une instance avec le texte du ExceptionMessageBox message d’erreur de niveau supérieur fourni et la légende de la boîte de dialogue de la zone de message d’exception.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Crée une instance avec le texte du ExceptionMessageBox message d’erreur de niveau supérieur fourni et la légende de la boîte de dialogue de la zone de message d’exception. Cette méthode spécifie également les boutons à 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 niveau supérieur fourni et la légende de boîte de dialogue de la boîte de message d'exception. Cette méthode spécifie également les boutons et le symbole à afficher dans la boîte de message d'exception.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Crée une instance de ExceptionMessageBox avec le texte du message d'erreur de niveau supérieur fourni et la légende de boîte de dialogue de la boîte de message. Cette 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, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Crée une instance de ExceptionMessageBox avec le texte du message d'erreur de niveau supérieur fourni et la légende de boîte de dialogue de la boîte de message. Cette méthode spécifie également les boutons, le symbole, le bouton par défaut et d'autres options de boîte de dialogue à afficher dans la boîte de message d'exception.

Propriétés

AbortButtonText	Obtient le texte par défaut du bouton Abandonner .
Beep	Spécifie s'il faut diffuser un son audible lorsque le message s'affiche.
Buttons	Obtient ou définit les boutons à afficher dans la boîte de message.
CancelButtonText	Obtient le texte par défaut du bouton Annuler .
Caption	Obtient ou définit la légende de boîte de dialogue de la boîte de message d'exception.
CheckBoxRegistryKey	Définit un RegistryKey ouvert qui contrôle la case à cocher affichée sur la boîte de message d'exception lorsque ShowCheckBox a la valeur `true`.
CheckBoxRegistryMeansDoNotShowDialog	Détermine si le contenu de valeur de Registre spécifié par CheckBoxRegistryKey et CheckBoxRegistryValue indique une décision précédente de l'utilisateur de ne pas afficher ce message.
CheckBoxRegistryValue	Obtient ou définit le nom de la valeur de Registre qui contrôle la case à cocher sur la boîte de message d'exception lorsque ShowCheckBox a la valeur `true`.
CheckBoxText	Obtient ou définit le texte à afficher dans la case à cocher sur la boîte de message d'exception lorsque ShowCheckBox a la valeur `true`.
CustomDialogResult	Obtient le bouton de la boîte de dialogue du texte personnalisé sur lequel l'utilisateur a cliqué.
CustomSymbol	Obtient ou définit une image bitmap personnalisée à 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 niveau supérieur.
DefaultButton	Obtient ou définit le bouton par défaut sur la boîte de message.
DefaultDialogResult	Obtient ou définit la valeur retournée par la méthode Show(IWin32Window) lorsque l'utilisateur a indiqué précédemment de ne pas afficher à nouveau un message donné.
FailButtonText	Obtient le texte par défaut du bouton Échec .
Font	Obtient ou définit la police utilisée dans la boîte de message.
HelpLink	Obtient ou définit le lien au fichier d'aide ou à la page Web d'aide associé au message de niveau supérieur.
IgnoreButtonText	Obtient le texte par défaut du bouton Ignorer .
InnerException	Obtient ou définit l'instance de Exception associée aux messages de niveau inférieur.
IsCheckBoxChecked	Spécifie si la case à cocher est activée lorsque ShowCheckBox a la valeur `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	Obtient le texte par défaut du bouton Non
OKButtonText	Obtient le texte par défaut du bouton OK
Options	Obtient ou définit les diverses options d'affichage pour la boîte de message.
RetryButtonText	Obtient le texte par défaut du bouton Réessayer .
ShowCheckBox	Spécifie s'il faut afficher la case à cocher dans la boîte de message d'exception.
ShowToolBar	Spécifie s'il faut afficher la barre d'outils de boutons de commande sur la boîte de message d'exception.
Symbol	Obtient ou définit le symbole à afficher dans la boîte de message d'exception.
Text	Obtient ou définit le texte du message de niveau supérieur à afficher dans la boîte de message d'exception.
UseOwnerFont	Spécifie 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 du bouton Oui

Méthodes

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)	Définit le texte pour le bouton de texte personnalisé lorsqu'un seul bouton est affiché dans la boîte de message d'exception.
SetButtonText(String, String)	Définit le texte pour les boutons de texte personnalisés lorsque deux boutons uniquement sont affichés dans la boîte de message d'exception.
SetButtonText(String, String, String)	Définit le texte pour les boutons de texte personnalisés lorsque trois boutons uniquement sont affichés dans la boîte de message d'exception.
SetButtonText(String, String, String, String)	Définit le texte pour les boutons de texte personnalisés lorsque quatre boutons uniquement sont affichés dans la boîte de message d'exception.
SetButtonText(String, String, String, String, String)	Définit le texte pour les boutons de texte personnalisés lorsque cinq boutons uniquement sont affichés 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 pris en charge. La compatibilité future n'est pas garantie.
Show(IWin32Window)	Affiche la boîte de message d'exception sous la forme d'une boîte de dialogue modale centrée sur la fenêtre parente.

Événements

OnCopyToClipboard

Se produit lorsque le texte du message d'exception est copié de la boîte de message vers le Presse-papiers.

S’applique à