CommonDialog.ShowDialog Method (Window)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Displays a common dialog.

Namespace:   Microsoft.Win32
Assembly:  PresentationFramework (in PresentationFramework.dll)

public Nullable<bool> ShowDialog(
	Window owner


Type: System.Windows.Window

Handle to the window that owns the dialog.

Return Value

Type: System.Nullable<Boolean>

If the user clicks the OK button of the dialog that is displayed (e.g. OpenFileDialog, SaveFileDialog), true is returned; otherwise, false.

ShowDialog performs initialization tasks for all common dialogs before calling RunDialog. Additionally, the dialog that is eventually shown is assigned an owner window, which is specified by the owner parameter.

In the current implementation, the derived classes (OpenFileDialog and SaveFileDialog) will only return true or false.


to execute this method without raising of an exception. Associated enumeration: AllWindows

.NET Framework
Available since 3.0
Return to top