• Article

ExceptionMessageBox Constructor (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.

Namespace:  Microsoft.SqlServer.MessageBox
Assembly:  Microsoft.ExceptionMessageBox (in Microsoft.ExceptionMessageBox.dll)

Syntax

'Declaration
Public Sub New ( _
    text As String, _
    caption As String, _
    buttons As ExceptionMessageBoxButtons, _
    symbol As ExceptionMessageBoxSymbol, _
    defaultButton As ExceptionMessageBoxDefaultButton _
)
'Usage
Dim text As String
Dim caption As String
Dim buttons As ExceptionMessageBoxButtons
Dim symbol As ExceptionMessageBoxSymbol
Dim defaultButton As ExceptionMessageBoxDefaultButton

Dim instance As New ExceptionMessageBox(text, caption, _
    buttons, symbol, defaultButton)

public ExceptionMessageBox(
    string text,
    string caption,
    ExceptionMessageBoxButtons buttons,
    ExceptionMessageBoxSymbol symbol,
    ExceptionMessageBoxDefaultButton defaultButton
)

public:
ExceptionMessageBox(
    String^ text, 
    String^ caption, 
    ExceptionMessageBoxButtons buttons, 
    ExceptionMessageBoxSymbol symbol, 
    ExceptionMessageBoxDefaultButton defaultButton
)

new : 
        text:string * 
        caption:string * 
        buttons:ExceptionMessageBoxButtons * 
        symbol:ExceptionMessageBoxSymbol * 
        defaultButton:ExceptionMessageBoxDefaultButton -> ExceptionMessageBox

public function ExceptionMessageBox(
    text : String, 
    caption : String, 
    buttons : ExceptionMessageBoxButtons, 
    symbol : ExceptionMessageBoxSymbol, 
    defaultButton : ExceptionMessageBoxDefaultButton
)

Parameters

  • caption
    Type: System.String
    Dialog box caption of 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