Window.DialogResult Property

Gets or sets the dialog result value, which is the value that is returned from the ShowDialog method.

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

[TypeConverterAttribute(typeof(DialogResultConverter))]
public Nullable<bool> DialogResult { get; set; }

Property Value

Type: System.Nullable<Boolean>
A Nullable<T> value of type Boolean. The default is false.

ExceptionCondition
InvalidOperationException

DialogResult is set before a window is opened by calling ShowDialog.

-or-

DialogResult is set on a window that is opened by calling Show.

DialogResult can be used from the code that showed a dialog box to determine whether a user accepted (true) or canceled (false) the dialog box. If a dialog box was accepted, this signifies to the code that opened the dialog box to retrieve the data that was collected by the user and process it. If a dialog box was canceled, however, this signifies that calling code should stop any further processing.

By default, a dialog box is canceled when a user does one of the following:

  • PressesALT+F4.

  • Clicks the Close button.

  • Selects Close from the System menu.

In all of these cases, DialogResult is false by default.

A dialog box typically provides a special button to cancel a dialog, which is the button whose IsCancel property is set to true. A button configured this way will automatically close a window when either it is pressed, or when the ESC key is pressed. In either of these cases, DialogResult remains false.

A dialog box also typically provides an accept button, which is the button whose IsDefault property is set to true. A button configured this way will raise its Click event when either it or the ENTER key is pressed. However, it won't automatically close the dialog box, nor will it set DialogResult to true. You need to manually write this code, usually from the Click event handler for the default button.

DialogResult is null when the dialog box is shown but neither accepted nor canceled.

After a dialog box closes, you can get the dialog result from the value returned by ShowDialog method, or by inspecting the DialogResult property.

DialogResult can only be set when a Window is opened by calling its ShowDialog method.

NoteNote

You cannot set or get this property when a window is hosted in a browser.

The following example shows how to configure an OK button and a Cancel button to return the appropriate DialogResult.

<Button IsDefault="True" Click="acceptButton_Click">OK (IsDefault=True)</Button>
<Button IsCancel="True">Cancel (IsCancel=True)</Button>
using System;
using System.Windows;
using System.Windows.Controls;

namespace CSharp
{
    public partial class DialogBox : Window
    {
        public DialogBox()
        {
            InitializeComponent();
        }

        // The accept button is a button whose IsDefault property is set to true. 
        // This event is raised whenever this button is clicked, or the ENTER key 
        // is pressed. 
        void acceptButton_Click(object sender, RoutedEventArgs e)
        {
            // Accept the dialog and return the dialog result 
            this.DialogResult = true;
        }
    }
}

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft