ExceptionMessageBox.ShowCheckBox Property

Definition

Specifies whether to show the check box in the exception message box.

public:
 property bool ShowCheckBox { bool get(); void set(bool value); };
public bool ShowCheckBox { get; set; }
member this.ShowCheckBox : bool with get, set
Public Property ShowCheckBox As Boolean

Property Value

Boolean

A Boolean value.

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

Remarks

The value of the check box can be evaluated at runtime when an exception occurs to determine whether to display the exception message box. For more information, see Program Exception Message Box.

The default value is false.

Applies to

See also