ExceptionMessageBox Klasse

Definition

Namespace:

Microsoft.SqlServer.MessageBox

Assembly:

Microsoft.ExceptionMessageBox.dll

Zeigt ein Nachrichtenfeld an, das mit Text, Buttons und Symbolen angepasst werden kann, um das Kundenerlebnis mit einer Microsoft Windows .NET Framework-basierten Anwendung zu verbessern.

public ref class ExceptionMessageBox

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

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

Public Class ExceptionMessageBox

Vererbung

Object

ExceptionMessageBox

Attribute

ComVisibleAttribute

Beispiele

Dieses Beispiel zeigt das Nachrichtenfeld mit einem OK-Button an.

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

Dieses Beispiel verwendet das Ausnahme-Meldefeld, um zusätzliche Informationen anzuzeigen, die bei der Fehlersuche oder beim Debuggen hilfreich sind.

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

Konstruktoren

Name	Beschreibung
ExceptionMessageBox()	Erstellt eine Instanz von ExceptionMessageBox mit den Standardeigenschaften.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Erstellt eine Instanz von ExceptionMessageBox durch Verwendung von Informationen aus den angegebenen Exception Optionen und durch Angabe der Schaltflächen, des Symbols, der Standard-Button und anderer Eigenschaften, die im Ausnahme-Nachrichtenfeld angezeigt werden.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Erstellt eine Instanz von durch ExceptionMessageBox die Verwendung von Informationen aus den angegebenen Exception Optionen und indem die Buttons, das Symbol und der Standard-Button angegeben werden, die im Ausnahme-Nachrichtenfeld angezeigt werden. .
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Erstellt eine Instanz von durch ExceptionMessageBox Verwendung von Informationen aus den angegebenen Exception Optionen und indem die Buttons und das Symbol im Nachrichtenfeld angezeigt werden.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Erstellt eine Instanz von durch ExceptionMessageBox Verwendung von Informationen aus den angegebenen Exception Optionen und indem die Buttons im Nachrichtenfeld angezeigt werden.
ExceptionMessageBox(Exception)	Erstellt eine Instanz von ExceptionMessageBox durch die Verwendung von Informationen aus dem angegebenen Exception.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Erstellt eine Instanz von ExceptionMessageBox mit dem bereitgestellten obersten Fehlermeldungstext und der Dialogbox-Bildunterschrift des Nachrichtenfelds. Die Methode spezifiziert außerdem die Buttons, das Symbol, die Standardtaste und die Dialogoptionen, die im Ausnahme-Nachrichtenfeld angezeigt werden sollen.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Erstellt eine Instanz von ExceptionMessageBox mit dem bereitgestellten obersten Fehlermeldungstext und der Dialogbox-Bildunterschrift des Nachrichtenfelds. Die Methode legt außerdem die Tasten, das Symbol und die Standardtaste fest, die im Ausnahme-Nachrichtenfeld angezeigt werden sollen.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Erstellt eine Instanz von ExceptionMessageBox mit dem bereitgestellten Fehlermeldungstext auf oberster Ebene und der Dialogfenster-Bildunterschrift des Ausnahme-Meldungsfelds. Die Methode spezifiziert außerdem die Buttons und das Symbol, die im Ausnahme-Nachrichtenfeld angezeigt werden sollen.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Erstellt eine Instanz von ExceptionMessageBox mit dem bereitgestellten Fehlermeldungstext auf oberster Ebene und der Bildunterschrift des Dialogfensters der Ausnahmemeldung. Die Methode legt außerdem Buttons fest, die im Ausnahme-Nachrichtenfeld angezeigt werden sollen.
ExceptionMessageBox(String, String)	Erstellt eine Instanz von ExceptionMessageBox mit dem bereitgestellten Fehlermeldungstext auf oberster Ebene und der Bildunterschrift des Dialogfensters der Ausnahmemeldung.
ExceptionMessageBox(String)	Erstellt eine Instanz von ExceptionMessageBox mit dem bereitgestellten obersten Fehlermeldungstext.

Eigenschaften

Name	Beschreibung
AbortButtonText	Erhält den Standardtext für die Abbruch-Taste .
Beep	Spezifiziert, ob ein hörbarer Ton abgespielt werden soll, wenn die Nachricht angezeigt wird.
Buttons	Erhält oder stellt die Buttons so ein, dass sie im Nachrichtenfeld angezeigt werden.
CancelButtonText	Erhält den Standardtext für den Abbrechen-Button .
Caption	Erhält oder setzt die Bildunterschrift des Dialogfensters im Ausnahme-Nachrichtenfeld ein.
CheckBoxRegistryKey	Setzt ein geöffnetesRegistryKey, das das Kontrollkästchen steuert, das im Ausnahme-Meldefeld angezeigt wird, wenn ShowCheckBox .true
CheckBoxRegistryMeansDoNotShowDialog	Bestimmt, ob das Register den von und angegebenen Inhalt wertet CheckBoxRegistryKey und CheckBoxRegistryValue auf eine Entscheidung des vorherigen Benutzers hinweist, diese Nachricht nicht anzusehen.
CheckBoxRegistryValue	Erhält oder setzt den Namen des Registrierungswerts, der das Kontrollkästchen im Ausnahme-Nachrichtenfeld steuert, wenn ShowCheckBox .true
CheckBoxText	Erhält oder setzt den Text so, dass er im Kontrollkästchen im Ausnahme-Meldefenster angezeigt wird, wenn ShowCheckBox .true
CustomDialogResult	Dort wird der benutzerdefinierte Text-Dialog-Button angezeigt.
CustomSymbol	Erhält oder setzt eine benutzerdefinierte Bitmap, die als Symbol im Ausnahme-Nachrichtenfeld verwendet wird.
Data	Erhält die IDictionary Schnittstelle, die Hilfeverbindungen und erweiterte Informationen speichert, die mit der obersten Nachricht verbunden sind.
DefaultButton	Erhält oder setzt den Standard-Button im Nachrichtenfeld.
DefaultDialogResult	Erhält oder setzt den von der Methode Show(IWin32Window) zurückgegebenen Wert, wenn der Benutzer zuvor angegeben hat, dass eine bestimmte Nachricht nicht erneut angezeigt wird.
FailButtonText	Es bekommt den Standardtext für die Fail-Taste .
Font	Erhält oder setzt die im Nachrichtenfeld verwendete Schriftart.
HelpLink	Erhält oder setzt den Link zur Hilfedatei oder zur Hilfeseite, die mit der obersten Nachricht verbunden ist.
IgnoreButtonText	Erhält den Standardtext für die Ignorieren-Taste .
InnerException	Erhält oder setzt die Instanz, die Exception mit den unteren Nachrichten assoziiert ist.
IsCheckBoxChecked	Gibt an, ob das Kontrollkästchen aktiviert wird, wenn ShowCheckBox .true
Message	Erhält oder setzt das Exception Signal, das die Nachricht enthält, um anzuzeigen.
MessageLevelDefault	Erhält oder legt die Anzahl der Nachrichtenstufen fest, die im Nachrichtenfeld angezeigt werden sollen.
NoButtonText	Erhält den Standardtext für die Nein-Taste
OKButtonText	Erhält den Standardtext für die OK-Schaltfläche
Options	Erhält oder setzt verschiedene Anzeigeoptionen für das Nachrichtenfeld
RetryButtonText	Es bekommt den Standardtext für die Schaltfläche "Erneut versuchen ".
ShowCheckBox	Gibt an, ob das Kontrollkästchen im Ausnahme-Nachrichtenfeld angezeigt werden soll.
ShowToolBar	Spezifiziert, ob die Befehls-Symbolleiste im Ausnahme-Nachrichtenfeld angezeigt werden soll.
Symbol	Erhält oder stellt das Symbol so, dass es im Ausnahme-Meldefeld angezeigt wird.
Text	Erhält oder setzt den Text der oberen Nachricht so, dass er im Ausnahme-Nachrichtenfeld angezeigt wird
UseOwnerFont	Spezifiziert, ob die Schriftart des Besitzerfensters abgerufen und als Schriftart für das Ausnahme-Nachrichtenfeld verwendet werden soll.
YesButtonText	Erhält den Standardtext für den Ja-Button

Methoden

Name	Beschreibung
GetMessageText(Exception)	Gibt die Zeichenkette zurück, die ein Benutzer auf die Zwischenablage kopieren kann, wenn die Ausnahme in einem Ausnahme-Meldefeld angezeigt wird.
SetButtonText(String, String, String, String, String)	Legt den Text für die benutzerdefinierten Textbuttons fest, wenn im Ausnahme-Nachrichtenfeld nur fünf Buttons angezeigt werden.
SetButtonText(String, String, String, String)	Legt den Text für die benutzerdefinierten Textbuttons fest, wenn im Ausnahme-Nachrichtenfeld nur vier Buttons angezeigt werden.
SetButtonText(String, String, String)	Setzt den Text für die benutzerdefinierten Texttasten, wenn nur drei Buttons im Ausnahme-Meldefeld angezeigt werden.
SetButtonText(String, String)	Legt den Text für die benutzerdefinierten Textbuttons fest, wenn im Ausnahme-Nachrichtenfeld nur zwei Buttons angezeigt werden.
SetButtonText(String)	Legt den Text für die benutzerdefinierte Text-Schaltfläche fest, wenn nur eine Taste im Ausnahme-Nachrichtenfeld angezeigt wird.
Show(IntPtr, String, String, String, String, String, String, String)	Zeigt das Ausnahme-Nachrichtenfeld an. Nur für Informationszwecke identifiziert. Nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.
Show(IWin32Window)	Zeigt das Ausnahme-Nachrichtenfeld als modales Dialogfeld, das auf das Elternfenster zentriert ist.

Ereignisse

Name	Beschreibung
OnCopyToClipboard	Tritt auf, wenn der Text einer Ausnahmemeldung aus dem Nachrichtenfeld in die Zwischenablage kopiert wird.