This documentation is archived and is not being maintained.
OpenFileDialog Class
Visual Studio 2010
Represents a common dialog box that allows a user to specify a filename for one or more files to open.
System::Object
Microsoft.Win32::CommonDialog
Microsoft.Win32::FileDialog
Microsoft.Win32::OpenFileDialog
Microsoft.Win32::CommonDialog
Microsoft.Win32::FileDialog
Microsoft.Win32::OpenFileDialog
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: Not mapped to an xmlns.
The OpenFileDialog type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | AddExtension | Gets or sets a value indicating whether a file dialog automatically adds an extension to a file name if the user omits an extension. (Inherited from FileDialog.) |
![]() | CheckFileExists | Gets or sets a value indicating whether a file dialog displays a warning if the user specifies a file name that does not exist. (Inherited from FileDialog.) |
![]() | CheckPathExists | Gets or sets a value that specifies whether warnings are displayed if the user types invalid paths and file names. (Inherited from FileDialog.) |
![]() | CustomPlaces | Gets or sets the list of custom places for file dialog boxes. (Inherited from FileDialog.) |
![]() | DefaultExt | Gets or sets a value that specifies the default extension string to use to filter the list of files that are displayed. (Inherited from FileDialog.) |
![]() | DereferenceLinks | Gets or sets a value indicating whether a file dialog returns either the location of the file referenced by a shortcut or the location of the shortcut file (.lnk). (Inherited from FileDialog.) |
![]() | FileName | Gets or sets a string containing the full path of the file selected in a file dialog. (Inherited from FileDialog.) |
![]() | FileNames | Gets an array that contains one file name for each selected file. (Inherited from FileDialog.) |
![]() | Filter | Gets or sets the filter string that determines what types of files are displayed from either the OpenFileDialog or SaveFileDialog. (Inherited from FileDialog.) |
![]() | FilterIndex | Gets or sets the index of the filter currently selected in a file dialog. (Inherited from FileDialog.) |
![]() | InitialDirectory | Gets or sets the initial directory that is displayed by a file dialog. (Inherited from FileDialog.) |
![]() | Multiselect | Gets or sets an option indicating whether OpenFileDialog allows users to select multiple files. |
![]() | Options | Gets the Win32 common file dialog flags that are used by file dialogs for initialization. (Inherited from FileDialog.) |
![]() | ReadOnlyChecked | Gets or sets a value indicating whether the read-only check box displayed by OpenFileDialog is selected. |
![]() | RestoreDirectory | This property is not implemented. (Inherited from FileDialog.) |
![]() | SafeFileName | Gets a string that only contains the file name for the selected file. (Inherited from FileDialog.) |
![]() | SafeFileNames | Gets an array that contains one safe file name for each selected file. (Inherited from FileDialog.) |
![]() | ShowReadOnly | Gets or sets a value indicating whether OpenFileDialog contains a read-only check box. |
![]() | Tag | Gets or sets an object associated with the dialog. This provides the ability to attach an arbitrary object to the dialog. (Inherited from CommonDialog.) |
![]() | Title | Gets or sets the text that appears in the title bar of a file dialog. (Inherited from FileDialog.) |
![]() | ValidateNames | Gets or sets a value indicating whether the dialog accepts only valid Win32 file names. (Inherited from FileDialog.) |
| Name | Description | |
|---|---|---|
![]() | CheckPermissionsToShowDialog | Determines whether sufficient permissions for displaying a dialog exist. (Inherited from CommonDialog.) |
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | HookProc | Defines the common file dialog hook procedure that is overridden to add common functionality to a file dialog. (Inherited from FileDialog.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | OnFileOk | Raises the FileOk event. (Inherited from FileDialog.) |
![]() | OpenFile | Opens a read-only stream for the file that is selected by the user using OpenFileDialog. |
![]() | OpenFiles | Creates an array that contains one read-only stream for each file selected by the user using OpenFileDialog. |
![]() | Reset | Resets all OpenFileDialog properties to their default values. (Overrides FileDialog::Reset().) |
![]() | RunDialog | RunDialog is called to display a file dialog in a derived class, such as OpenFileDialog and SaveFileDialog. (Inherited from FileDialog.) |
![]() | ShowDialog() | Displays a common dialog. (Inherited from CommonDialog.) |
![]() | ShowDialog(Window) | Displays a common dialog. (Inherited from CommonDialog.) |
![]() | ToString | Returns a string that represents a file dialog. (Inherited from FileDialog.) |
| Name | Description | |
|---|---|---|
![]() | FileOk | Occurs when the user selects a file name by either clicking the Open button of the OpenFileDialog or the Save button of the SaveFileDialog. (Inherited from FileDialog.) |
The following figure shows an OpenFileDialog for Windows Vista.

Starting in Windows Vista, open and save file dialog boxes have a Favorite Links panel on the left side of the dialog box that allows the user to quickly navigate to a different location. These links are called custom places. Use the CustomPlaces property to set this list of links.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show:
