ExceptionMessageBox Constructors

Reference

Definition

Namespace:: Microsoft.SqlServer.MessageBox

Assembly:: Microsoft.ExceptionMessageBox.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Overloaded constructor for ExceptionMessageBox.

Overloads

ExceptionMessageBox()	Creates an instance of ExceptionMessageBox with the default properties.
ExceptionMessageBox(Exception)	Creates an instance of ExceptionMessageBox by using information from the specified Exception.
ExceptionMessageBox(String)	Creates an instance of ExceptionMessageBox with the supplied top-level error message text.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)	Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons to display in the message box.
ExceptionMessageBox(String, String)	Creates an instance of ExceptionMessageBox with the supplied top-level error message text and the dialog box caption of the exception message box.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons and symbol to display in the message box.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)	Creates an instance of ExceptionMessageBox with the supplied top-level error message text and the dialog box caption of the exception message box. The method also specifies buttons to display in the exception message box.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons, symbol, and default button to display in the exception message box. .
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)	Creates an instance of ExceptionMessageBox with the supplied top-level error message text and dialog box caption of the exception message box. The method also specifies the buttons and symbol to display in the exception message box.
ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons, symbol, default button, and other properties to display in the exception message box.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)	Creates an instance of ExceptionMessageBox with the supplied top-level error message text and dialog box caption of the message box. The method also specifies the buttons, symbol, and default button to display in the exception message box.
ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)	Creates an instance of ExceptionMessageBox with the supplied top-level error message text and dialog box caption of the message box. The method also specifies the buttons, symbol, default button, and dialog options to display in the exception message box.

ExceptionMessageBox()

Creates an instance of ExceptionMessageBox with the default properties.

public:
 ExceptionMessageBox();

public ExceptionMessageBox ();

Public Sub New ()

Applies to

ExceptionMessageBox(Exception)

Creates an instance of ExceptionMessageBox by using information from the specified Exception.

public:
 ExceptionMessageBox(Exception ^ exception);

public ExceptionMessageBox (Exception exception);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : Exception -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (exception As Exception)

Parameters

exception: Exception

Exception that contains the top-level text, inner exception text, caption, data, help link, and optional additional information to display in the exception message box.

Examples

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

Applies to

ExceptionMessageBox(String)

Creates an instance of ExceptionMessageBox with the supplied top-level error message text.

public:
 ExceptionMessageBox(System::String ^ text);

public ExceptionMessageBox (string text);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : string -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (text As String)

Parameters

text: String

Error text of the top-level message.

Applies to

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)

Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons to display in the message box.

public:
 ExceptionMessageBox(Exception ^ exception, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxButtons buttons);

public ExceptionMessageBox (Exception exception, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons buttons);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : Exception * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (exception As Exception, buttons As ExceptionMessageBoxButtons)

Parameters

exception: Exception

Exception that contains the top-level text, inner exception text, caption, data, help link, and optional additional information to display in the exception message box.

buttons: ExceptionMessageBoxButtons

ExceptionMessageBoxButtons enumeration that specifies the buttons to display in the message box.

Applies to

ExceptionMessageBox(String, String)

Creates an instance of ExceptionMessageBox with the supplied top-level error message text and the dialog box caption of the exception message box.

public:
 ExceptionMessageBox(System::String ^ text, System::String ^ caption);

public ExceptionMessageBox (string text, string caption);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : string * string -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (text As String, caption As String)

Parameters

text: String

Error text of the top-level message.

caption: String

Caption of the exception message box.

Applies to

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)

Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons and symbol to display in the message box.

public:
 ExceptionMessageBox(Exception ^ exception, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxButtons buttons, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxSymbol symbol);

public ExceptionMessageBox (Exception exception, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons buttons, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol symbol);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : Exception * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (exception As Exception, buttons As ExceptionMessageBoxButtons, symbol As ExceptionMessageBoxSymbol)

Parameters

exception: Exception

Exception that contains the top-level text, inner exception text, caption, data, help link, and optional additional information to display in the exception message box.

buttons: ExceptionMessageBoxButtons

ExceptionMessageBoxButtons enumeration that specifies the buttons to display in the exception message box.

symbol: ExceptionMessageBoxSymbol

ExceptionMessageBoxSymbol enumeration that specifies the symbol to display in the exception message box.

Applies to

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)

Creates an instance of ExceptionMessageBox with the supplied top-level error message text and the dialog box caption of the exception message box. The method also specifies buttons to display in the exception message box.

public:
 ExceptionMessageBox(System::String ^ text, System::String ^ caption, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxButtons buttons);

public ExceptionMessageBox (string text, string caption, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons buttons);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : string * string * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (text As String, caption As String, buttons As ExceptionMessageBoxButtons)

Parameters

text: String

Error text of the top-level message.

caption: String

Caption of the exception message box.

buttons: ExceptionMessageBoxButtons

ExceptionMessageBoxButtons enumeration that specifies the buttons to display in the exception message box.

Applies to

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)

Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons, symbol, and default button to display in the exception message box. .

public:
 ExceptionMessageBox(Exception ^ exception, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxButtons buttons, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxSymbol symbol, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxDefaultButton defaultButton);

public ExceptionMessageBox (Exception exception, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons buttons, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol symbol, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxDefaultButton defaultButton);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : Exception * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxDefaultButton -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (exception As Exception, buttons As ExceptionMessageBoxButtons, symbol As ExceptionMessageBoxSymbol, defaultButton As ExceptionMessageBoxDefaultButton)

Parameters

exception: Exception

Exception that contains the top-level text, inner exception text, caption, data, help link, and optional additional information to display in the exception message box.

buttons: ExceptionMessageBoxButtons

ExceptionMessageBoxButtons enumeration that specifies the buttons to display in the exception message box.

symbol: ExceptionMessageBoxSymbol

ExceptionMessageBoxSymbol enumeration that specifies the symbol to display in the exception message box.

defaultButton: ExceptionMessageBoxDefaultButton

ExceptionMessageBoxDefaultButton enumeration that specifies the default button for the exception message box.

Applies to

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)

Creates an instance of ExceptionMessageBox with the supplied top-level error message text and dialog box caption of the exception message box. The method also specifies the buttons and symbol to display in the exception message box.

public:
 ExceptionMessageBox(System::String ^ text, System::String ^ caption, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxButtons buttons, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxSymbol symbol);

public ExceptionMessageBox (string text, string caption, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons buttons, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol symbol);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : string * string * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (text As String, caption As String, buttons As ExceptionMessageBoxButtons, symbol As ExceptionMessageBoxSymbol)

Parameters

text: String

Error text of the top-level message.

caption: String

Dialog box caption of the exception message box.

buttons: ExceptionMessageBoxButtons

ExceptionMessageBoxButtons enumeration that specifies the buttons to display in the exception message box.

symbol: ExceptionMessageBoxSymbol

ExceptionMessageBoxSymbol enumeration that specifies the symbol to display in the exception message box.

Applies to

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)

Creates an instance of ExceptionMessageBox by using information from the specified Exception and by specifying the buttons, symbol, default button, and other properties to display in the exception message box.

public:
 ExceptionMessageBox(Exception ^ exception, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxButtons buttons, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxSymbol symbol, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxDefaultButton defaultButton, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxOptions options);

public ExceptionMessageBox (Exception exception, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons buttons, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol symbol, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxDefaultButton defaultButton, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxOptions options);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : Exception * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxDefaultButton * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxOptions -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (exception As Exception, buttons As ExceptionMessageBoxButtons, symbol As ExceptionMessageBoxSymbol, defaultButton As ExceptionMessageBoxDefaultButton, options As ExceptionMessageBoxOptions)

Parameters

exception: Exception

Exception that contains the top-level text, inner exception text, caption, data, help link, and optional additional information to display in the exception message box.

buttons: ExceptionMessageBoxButtons

ExceptionMessageBoxButtons enumeration that specifies the buttons to display in the exception message box.

symbol: ExceptionMessageBoxSymbol

ExceptionMessageBoxSymbol enumeration that specifies the symbol to display in the exception message box.

defaultButton: ExceptionMessageBoxDefaultButton

ExceptionMessageBoxDefaultButton enumeration that specifies the default button for the exception message box.

options: ExceptionMessageBoxOptions

The ExceptionMessageBoxOptions enumeration that controls other behaviors of the exception message box.

Applies to

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)

Creates an instance of ExceptionMessageBox with the supplied top-level error message text and dialog box caption of the message box. The method also specifies the buttons, symbol, and default button to display in the exception message box.

public:
 ExceptionMessageBox(System::String ^ text, System::String ^ caption, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxButtons buttons, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxSymbol symbol, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxDefaultButton defaultButton);

public ExceptionMessageBox (string text, string caption, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons buttons, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol symbol, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxDefaultButton defaultButton);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : string * string * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxDefaultButton -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (text As String, caption As String, buttons As ExceptionMessageBoxButtons, symbol As ExceptionMessageBoxSymbol, defaultButton As ExceptionMessageBoxDefaultButton)

Parameters

text: String

Error text of the top-level message.

caption: String

Dialog box caption of the exception message box.

buttons: ExceptionMessageBoxButtons

ExceptionMessageBoxButtons enumeration that specifies the buttons to display in the exception message box.

symbol: ExceptionMessageBoxSymbol

ExceptionMessageBoxSymbol enumeration that specifies the symbol to display in the exception message box.

defaultButton: ExceptionMessageBoxDefaultButton

ExceptionMessageBoxDefaultButton enumeration that specifies the default button for the exception message box.

Examples

// Define the message and caption to display.
string str = @"Are you sure you want to delete file 'c:\somefile.txt'?";
string caption = "Confirm File Deletion";

// Show the exception message box with Yes and No buttons.
ExceptionMessageBox box = new ExceptionMessageBox(str,
    caption, ExceptionMessageBoxButtons.YesNo,
    ExceptionMessageBoxSymbol.Question,
    ExceptionMessageBoxDefaultButton.Button2);

if (DialogResult.Yes == box.Show(this))
{
    // Delete the file.
}

' Define the message and caption to display.
Dim str As String = "Are you sure you want to delete file 'c:\somefile.txt'?"
Dim caption As String = "Confirm File Deletion"

' Show the exception message box with Yes and No buttons.
Dim box As ExceptionMessageBox = New ExceptionMessageBox(str, _
 caption, ExceptionMessageBoxButtons.YesNo, _
 ExceptionMessageBoxSymbol.Question, _
 ExceptionMessageBoxDefaultButton.Button2)

If Windows.Forms.DialogResult.Yes = box.Show(Me) Then
    ' Delete the file.
End If

Applies to

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)

Creates an instance of ExceptionMessageBox with the supplied top-level error message text and dialog box caption of the message box. The method also specifies the buttons, symbol, default button, and dialog options to display in the exception message box.

public:
 ExceptionMessageBox(System::String ^ text, System::String ^ caption, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxButtons buttons, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxSymbol symbol, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxDefaultButton defaultButton, Microsoft::SqlServer::MessageBox::ExceptionMessageBoxOptions options);

public ExceptionMessageBox (string text, string caption, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons buttons, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol symbol, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxDefaultButton defaultButton, Microsoft.SqlServer.MessageBox.ExceptionMessageBoxOptions options);

new Microsoft.SqlServer.MessageBox.ExceptionMessageBox : string * string * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxButtons * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxSymbol * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxDefaultButton * Microsoft.SqlServer.MessageBox.ExceptionMessageBoxOptions -> Microsoft.SqlServer.MessageBox.ExceptionMessageBox

Public Sub New (text As String, caption As String, buttons As ExceptionMessageBoxButtons, symbol As ExceptionMessageBoxSymbol, defaultButton As ExceptionMessageBoxDefaultButton, options As ExceptionMessageBoxOptions)

Parameters

text: String

Error text of the top-level message.

caption: String

Dialog box caption of the exception message box.

buttons: ExceptionMessageBoxButtons

ExceptionMessageBoxSymbol enumeration that specifies the symbol to display in the exception message box.

symbol: ExceptionMessageBoxSymbol

ExceptionMessageBoxSymbol enumeration that specifies the symbol to display in the exception message box.

defaultButton: ExceptionMessageBoxDefaultButton

ExceptionMessageBoxDefaultButton enumeration that specifies the default button for the exception message box.

options: ExceptionMessageBoxOptions

The ExceptionMessageBoxOptions enumeration that controls other behaviors of the exception message box.

Applies to

共用方式為

ExceptionMessageBox Constructors

Definition

Overloads

ExceptionMessageBox()

Applies to

ExceptionMessageBox(Exception)

Parameters

Examples

Applies to

ExceptionMessageBox(String)

Parameters

Applies to

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons)

Parameters

Applies to

ExceptionMessageBox(String, String)

Parameters

Applies to

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)

Parameters

Applies to

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons)

Parameters

Applies to

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)

Parameters

Applies to

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol)

Parameters

Applies to

ExceptionMessageBox(Exception, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)

Parameters

Applies to

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton)

Parameters

Examples

Applies to

ExceptionMessageBox(String, String, ExceptionMessageBoxButtons, ExceptionMessageBoxSymbol, ExceptionMessageBoxDefaultButton, ExceptionMessageBoxOptions)

Parameters

Applies to

其他資源