ExceptionMessageBox Klasse

Referenz

Definition

Namespace:: Microsoft.SqlServer.MessageBox

Assembly:: Microsoft.ExceptionMessageBox.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Zeigt ein Meldungsfeld an, das mit Text, Schaltflächen und Symbolen angepasst werden kann, um die Kundenfreundlichkeit 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

In diesem Beispiel wird das Meldungsfeld mit einer OK-Schaltfläche angezeigt.

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

In diesem Beispiel wird das Ausnahmemeldungsfeld verwendet, um weitere Informationen anzuzeigen, die bei der Problembehandlung oder beim Debuggen hilfreich sein können.

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

ExceptionMessageBox()	Erstellt eine ExceptionMessageBox-Instanz mit den Standardeigenschaften.
ExceptionMessageBox(Exception)	Erstellt unter Verwendung von Informationen aus der angegebenen ExceptionMessageBox eine Exception-Instanz.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Erstellt eine ExceptionMessageBox-Instanz, indem Informationen aus der angegebenen Exception verwendet und die Schaltflächen angegeben werden, die im Meldungsfeld angezeigt werden.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Erstellt eine ExceptionMessageBox-Instanz, indem Informationen aus der angegebenen Exception verwendet und die Schaltflächen sowie das Symbol angegeben werden, die im Meldungsfeld angezeigt werden.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Erstellt eine ExceptionMessageBox-Instanz, indem Informationen aus der angegebenen Exception verwendet und die Schaltflächen, das Symbol und die Standardschaltfläche angegeben werden, die im Ausnahmemeldungsfeld angezeigt werden. .
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Erstellt eine ExceptionMessageBox-Instanz, indem Informationen aus der angegebenen Exception verwendet und die Schaltflächen, das Symbol, die Standardschaltfläche und weitere Eigenschaften angegeben werden, die im Ausnahmemeldungsfeld angezeigt werden.
ExceptionMessageBox(String)	Erstellt eine ExceptionMessageBox-Instanz mit dem angegebenen Fehlermeldungstext der obersten Ebene.
ExceptionMessageBox(String, String)	Erstellt eine Instanz mit ExceptionMessageBox dem angegebenen Fehlermeldungstext auf oberster Ebene und der Beschriftung des Dialogfelds des Ausnahmemeldungsfelds.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Erstellt eine Instanz mit ExceptionMessageBox dem angegebenen Fehlermeldungstext auf oberster Ebene und der Beschriftung des Dialogfelds des Ausnahmemeldungsfelds. Die Methode gibt auch die im Ausnahmemeldungsfeld anzuzeigenden Schaltflächen an.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Erstellt eine ExceptionMessageBox-Instanz unter Verwendung des angegebenen Fehlermeldungstexts der obersten Ebene und der Dialogfeldbeschriftung des Ausnahmemeldungsfelds. Die Methode gibt auch die Schaltflächen und das Symbol an, die im Ausnahmemeldungsfeld angezeigt werden.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Erstellt eine ExceptionMessageBox-Instanz unter Verwendung des angegebenen Fehlermeldungstexts der obersten Ebene und der Dialogfeldbeschriftung des Meldungsfelds. Die Methode gibt auch die Schaltflächen, das Symbol und die Standardschaltfläche an, die im Ausnahmemeldungsfeld angezeigt werden.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Erstellt eine ExceptionMessageBox-Instanz unter Verwendung des angegebenen Fehlermeldungstexts der obersten Ebene und der Dialogfeldbeschriftung des Meldungsfelds. Die Methode gibt auch die Schaltflächen, das Symbol, die Standardschaltfläche und die Dialogfeldoptionen an, die im Ausnahmemeldungsfeld angezeigt werden sollen.

Eigenschaften

AbortButtonText	Ruft den Standardtext für die Schaltfläche "Abbrechen" ab .
Beep	Gibt an, ob bei der Anzeige der Meldung ein akustisches Signal ausgegeben wird.
Buttons	Ruft die Schaltflächen ab, die im Meldungsfeld angezeigt werden sollen, oder legt sie fest.
CancelButtonText	Ruft den Standardtext für die Schaltfläche "Abbrechen " ab.
Caption	Ruft die Dialogfeldbeschriftung des Ausnahmemeldungsfelds ab oder legt sie fest.
CheckBoxRegistryKey	Legt einen geöffneten RegistryKey fest, mit dem das Kontrollkästchen gesteuert wird, das im Ausnahmemeldungsfeld angezeigt wird, wenn ShowCheckBox den Wert `true` hat.
CheckBoxRegistryMeansDoNotShowDialog	Bestimmt, ob der von CheckBoxRegistryKey und CheckBoxRegistryValue angegebene Inhalt des Registrierungswerts angibt, dass ein Benutzer zuvor bereits entschieden hat, diese Meldung nicht anzuzeigen.
CheckBoxRegistryValue	Ruft den Namen des Registrierungswerts ab, mit dem das Kontrollkästchen im Ausnahmemeldungsfeld gesteuert wird, wenn ShowCheckBox den Wert `true` aufweist, oder legt diesen fest.
CheckBoxText	Ruft den Text ab, der für das Kontrollkästchen im Ausnahmemeldungsfeld angezeigt werden soll, wenn ShowCheckBox den Wert `true` aufweist, oder legt diesen fest.
CustomDialogResult	Ruft die benutzerdefinierte Textschaltfläche ab, auf die im Dialogfeld geklickt wurde.
CustomSymbol	Ruft eine benutzerdefinierte Bitmap ab, die im Ausnahmemeldungsfeld als Symbol verwendet werden soll, oder legt sie fest.
Data	Ruft die IDictionary-Schnittstelle ab, von der der Hilfelink und weiterführende Informationen zur Meldung der obersten Ebene gespeichert werden.
DefaultButton	Ruft die Standardschaltfläche im Meldungsfeld ab oder legt sie fest.
DefaultDialogResult	Ruft den Wert ab, der von der Show(IWin32Window)-Methode zurückgegeben wird, wenn der Benutzer zuvor angegeben hat, dass eine bestimmte Meldung nicht mehr angezeigt werden soll, oder legt ihn fest.
FailButtonText	Ruft den Standardtext für die Schaltfläche "Fehler" ab.
Font	Ruft die im Meldungsfeld verwendete Schriftart ab oder legt sie fest.
HelpLink	Ruft den Link zur Hilfedatei oder Hilfewebseite ab, die der Meldung der obersten Ebene zugeordnet ist, oder legt diesen fest.
IgnoreButtonText	Ruft den Standardtext für die Schaltfläche "Ignorieren " ab.
InnerException	Ruft die Exception-Instanz ab, die Meldungen auf untergeordneten Ebenen zugeordnet ist, oder legt sie fest.
IsCheckBoxChecked	Gibt an, ob das Kontrollkästchen aktiviert wird, wenn ShowCheckBox den Wert `true` aufweist.
Message	Ruft die Exception ab, die die anzuzeigende Meldung enthält, oder legt sie fest.
MessageLevelDefault	Ruft die Anzahl der im Meldungsfeld anzuzeigenden Meldungsebenen ab oder legt sie fest.
NoButtonText	Ruft den Standardtext für die Schaltfläche "Nein " ab.
OKButtonText	Ruft den Standardtext für die Schaltfläche "OK " ab.
Options	Ruft verschiedene Anzeigeoptionen für das Meldungsfeld ab oder legt sie fest.
RetryButtonText	Ruft den Standardtext für die Schaltfläche "Wiederholen" ab.
ShowCheckBox	Gibt an, ob das Kontrollkästchen im Ausnahmemeldungsfeld angezeigt werden soll.
ShowToolBar	Gibt an, ob die Symbolleiste mit Befehlsschaltflächen im Ausnahmemeldungsfeld angezeigt werden soll.
Symbol	Ruft das im Ausnahmemeldungsfeld anzuzeigende Symbol ab oder legt es fest.
Text	Ruft den Text der Meldung auf oberster Ebene ab, der im Ausnahmemeldungsfeld angezeigt werden soll, oder legt ihn fest.
UseOwnerFont	Gibt an, ob die Schriftart des Besitzerfensters abgerufen und für das Ausnahmemeldungsfeld verwendet werden soll.
YesButtonText	Ruft den Standardtext für die Schaltfläche "Ja " ab.

Methoden

GetMessageText(Exception)	Gibt die Zeichenfolge zurück, die ein Benutzer in die Zwischenablage kopieren kann, wenn die Ausnahme in einem Ausnahmemeldungsfeld angezeigt wird.
SetButtonText(String)	Legt den Text für die benutzerdefinierte Textschaltfläche fest, wenn im Ausnahmemeldungsfeld nur eine Schaltfläche angezeigt wird.
SetButtonText(String, String)	Legt den Text für die benutzerdefinierten Textschaltflächen fest, wenn im Ausnahmemeldungsfeld nur zwei Schaltflächen angezeigt werden.
SetButtonText(String, String, String)	Legt den Text für die benutzerdefinierten Textschaltflächen fest, wenn im Ausnahmemeldungsfeld nur drei Schaltflächen angezeigt werden.
SetButtonText(String, String, String, String)	Legt den Text für die benutzerdefinierten Textschaltflächen fest, wenn im Ausnahmemeldungsfeld nur vier Schaltflächen angezeigt werden.
SetButtonText(String, String, String, String, String)	Legt den Text für die benutzerdefinierten Textschaltflächen fest, wenn im Ausnahmemeldungsfeld nur fünf Schaltflächen angezeigt werden.
Show(IntPtr, String, String, String, String, String, String, String)	Zeigt das Ausnahmemeldungsfeld an. Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.
Show(IWin32Window)	Zeigt das Ausnahmemeldungsfeld als modales, im übergeordneten Fenster zentriertes Dialogfeld an.

Ereignisse

OnCopyToClipboard

Tritt auf, wenn Ausnahmemeldungstext aus dem Meldungsfeld in die Zwischenablage kopiert wird.

Gilt für: