• Article

ExceptionMessageBox.IsCheckBoxChecked Property

Specifies whether the check box is selected when ShowCheckbox() is true.

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

Syntax

'Declaration
Public Property IsCheckBoxChecked As Boolean
    Get
    Set
'Usage
Dim instance As ExceptionMessageBox
Dim value As Boolean

value = instance.IsCheckBoxChecked

instance.IsCheckBoxChecked = value

public bool IsCheckBoxChecked { get; set; }

public:
property bool IsCheckBoxChecked {
    bool get ();
    void set (bool value);
}

member IsCheckBoxChecked : bool with get, set

function get IsCheckBoxChecked () : boolean
function set IsCheckBoxChecked (value : boolean)

Property Value

Type: System.Boolean
A Boolean value.

Remarks

The default value is false.

Examples

            try
            {
                // Do something that may cause an exception.
                throw new ApplicationException("An error has occured.");
            }
            catch (ApplicationException ex)
            {
                string str = "The action failed.";
                ApplicationException exTop = new ApplicationException(str, ex);
                exTop.Source = this.Text;

                // Show a message box if the global variable is true.
                if (alwaysShow)
                {
                    ExceptionMessageBox box = new ExceptionMessageBox(exTop);
                    box.ShowCheckBox = true;
                    box.IsCheckBoxChecked = true;
                    box.CheckBoxText = "Always show this message";
                    box.Show(this);

                    // Set the global variable.
                    alwaysShow = box.IsCheckBoxChecked;
                }
            }

Try
    ' Do something that may cause an exception.
    Throw New ApplicationException("An error has occured.")
Catch ex As ApplicationException
    Dim str As String = "The action failed."
    Dim exTop As ApplicationException = New ApplicationException(str, ex)
    exTop.Source = Me.Text

    ' Show a message box if the global variable is true.
    If alwaysShow Then
        Dim box As ExceptionMessageBox = New ExceptionMessageBox(exTop)
        box.ShowCheckBox = True
        box.IsCheckBoxChecked = True
        box.CheckBoxText = "Always show this message"
        box.Show(Me)

        ' Set the global variable.
        alwaysShow = box.IsCheckBoxChecked
    End If
End Try