SaveFileDialog Class
.NET Framework 4.5
Represents a common dialog that allows the user to specify a filename to save a file as. SaveFileDialog cannot be used by an application that is executing under partial trust.
System.Object
Microsoft.Win32.CommonDialog
Microsoft.Win32.FileDialog
Microsoft.Win32.SaveFileDialog
Microsoft.Win32.CommonDialog
Microsoft.Win32.FileDialog
Microsoft.Win32.SaveFileDialog
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: Not mapped to an xmlns.
The SaveFileDialog 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.) |
| CreatePrompt | Gets or sets a value indicating whether SaveFileDialog prompts the user for permission to create a file if the user specifies a file that does not exist. |
| 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.) |
| OverwritePrompt | Gets or sets a value indicating whether SaveFileDialog displays a warning if the user specifies the name of a file that already exists. |
| 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.) |
| 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 | |
|---|---|---|
| Equals(Object) | Determines whether the specified object is equal to the current object. (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.) |
| OpenFile | Creates a read-write file stream for the filename selected by the user using SaveFileDialog. |
| Reset | Resets all SaveFileDialog properties to their default values. (Overrides FileDialog.Reset().) |
| 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 a SaveFileDialog 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.
The following example demonstrates how to create a SaveFileDialog and process the result.
// Configure save file dialog box Microsoft.Win32.SaveFileDialog dlg = new Microsoft.Win32.SaveFileDialog(); dlg.FileName = "Document"; // Default file name dlg.DefaultExt = ".text"; // Default file extension dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension // Show save file dialog box Nullable<bool> result = dlg.ShowDialog(); // Process save file dialog box results if (result == true) { // Save document string filename = dlg.FileName; }
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.
