SaveFileDialog Класс

Определение

Пространство имен:

Microsoft.Win32

Сборка:

PresentationFramework.dll

Представляет общее диалоговое окно, позволяющее пользователю задать имя файла, чтобы сохранить файл под другим именем. Объект SaveFileDialog не может использоваться приложением, выполняемым с частичным доверием.

public ref class SaveFileDialog sealed : Microsoft::Win32::FileDialog

public sealed class SaveFileDialog : Microsoft.Win32.FileDialog

type SaveFileDialog = class
    inherit FileDialog

Public NotInheritable Class SaveFileDialog
Inherits FileDialog

Наследование

Object

CommonDialog

CommonItemDialog

FileDialog

SaveFileDialog

Примеры

В следующем примере показано, как создать SaveFileDialog и обработать результат.

// Configure save file dialog box
Microsoft.Win32.SaveFileDialog dlg = new Microsoft.Win32.SaveFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // 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;
}

' Configure save file dialog box
Dim dlg As New Microsoft.Win32.SaveFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show save file dialog box
Dim result? As Boolean = dlg.ShowDialog()

' Process save file dialog box results
If result = True Then
    ' Save document
    Dim filename As String = dlg.FileName
End If

Комментарии

Этот управляемый класс нельзя объявить в XAML.

Конструкторы

SaveFileDialog()

Инициализирует новый экземпляр класса SaveFileDialog.

Свойства

AddExtension	Получает или задает значение, указывающее, добавляет ли диалоговое окно открытия или сохранения файла расширение к имени файла автоматически, если пользователь опустил расширение. (Унаследовано от FileDialog)
AddToRecent	Возвращает или задает значение, указывающее, будет ли диалоговое окно добавлять открываемый или сохраненный элемент в список последних документов. (Унаследовано от CommonItemDialog)
CheckFileExists	Получает или задает значение, указывающее, отображает ли диалоговое окно открытия или сохранения файла предупреждение, если пользователь указал несуществующее имя файла. (Унаследовано от FileDialog)
CheckPathExists	Получает или задает значение, указывающее, отображается ли предупреждение, если пользователь вводит неверный путь или имя файла. (Унаследовано от FileDialog)
ClientGuid	Возвращает или задает GUID для связи с сохраненным состоянием диалога. (Унаследовано от CommonItemDialog)
CreatePrompt	Получает или задает значение, показывающее, будет ли диалоговое окно SaveFileDialog запрашивать у пользователя разрешение на создание файла, если указанный пользователем файл не существует.
CreateTestFile	Возвращает или задает значение, указывающее, будет ли диалоговое окно пытаться создать тестовый файл по выбранному пути.
CustomPlaces	Получает или задает список настраиваемых расположений для диалоговых окон. (Унаследовано от FileDialog)
DefaultDirectory	Возвращает или задает каталог, отображаемый в диалоговом окне файла, если не доступно значение недавно использованного каталога. (Унаследовано от CommonItemDialog)
DefaultExt	Получает или задает строковое значение, которое определяет расширение, используемое по умолчанию для фильтрации списка отображаемых файлов. (Унаследовано от FileDialog)
DereferenceLinks	Получает или задает значение, указывающее, что диалоговое окно возвращает местоположение файла, на который указывает ярлык, или местоположение файла ярлыка (LNK-файла). (Унаследовано от FileDialog)
FileName	Получает или задает строку, содержащую полный путь к файлу, выбранному в диалоговом окне открытия или сохранения файла. (Унаследовано от FileDialog)
FileNames	Получает массив, содержащий имена всех выбранных файлов. (Унаследовано от FileDialog)
Filter	Получает или задает строку фильтра, определяющую, какие типы файлов отображаются в диалоговом окне OpenFileDialog или SaveFileDialog. (Унаследовано от FileDialog)
FilterIndex	Получает или задает индекс фильтра, выбранного в настоящий момент в диалоговом окне открытия или сохранения файла. (Унаследовано от FileDialog)
InitialDirectory	Получает или задает начальный каталог, отображаемый диалоговым окном открытия или сохранения файла. (Унаследовано от FileDialog)
Options	Возвращает флаги общих диалоговых окон Win32, которые используются диалогами файлов для инициализации. (Унаследовано от FileDialog)
OverwritePrompt	Получает или задает значение, показывающее, будет ли диалоговое окно SaveFileDialog выводить предупреждение, если файл с указанным именем уже существует.
RestoreDirectory	Это свойство не реализовано. (Унаследовано от FileDialog)
RootDirectory	Возвращает или задает каталог, отображаемый в качестве корневого элемента навигации для диалогового окна. (Унаследовано от CommonItemDialog)
SafeFileName	Получает строку, содержащую только имя выбранного файла. (Унаследовано от FileDialog)
SafeFileNames	Получает массив, содержащий по одному безопасному имени для каждого выбранного файла. (Унаследовано от FileDialog)
ShowHiddenItems	Возвращает или задает значение, указывающее, будут ли в диалоговом окне отображаться скрытые и системные элементы независимо от предпочтений пользователя. (Унаследовано от CommonItemDialog)
Tag	Получает или задает объект, связанный с диалоговым окном. Таким образом, обеспечивает возможность присоединить к диалоговому окну произвольный объект. (Унаследовано от CommonDialog)
Title	Получает или задает текст строки заголовка диалогового окна открытия или сохранения файла. (Унаследовано от FileDialog)
ValidateNames	Возвращает или задает значение, указывающее, принимает ли диалоговое окно только допустимые имена файлов Win32. (Унаследовано от FileDialog)

Методы

CheckPermissionsToShowDialog()	Определяет, достаточны ли разрешения для отображения диалогового окна. (Унаследовано от CommonDialog)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Определяет процедуру обработки стандартного диалогового окна открытия или сохранения файла, переопределенную для добавления в диалоговое окно общих функций. (Унаследовано от FileDialog)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnFileOk(CancelEventArgs)	Вызывает событие FileOk. (Унаследовано от FileDialog)
OnItemOk(CancelEventArgs)	Вызывает событие FileOk. (Унаследовано от FileDialog)
OpenFile()	Создает файловый поток на чтение и запись для имени файла, выбранного пользователем с помощью диалогового окна SaveFileDialog.
Reset()	Восстанавливает для всех свойств SaveFileDialog значения по умолчанию.
RunDialog(IntPtr)	RunDialog(IntPtr) вызывается для отображения диалогового окна открытия или сохранения файла в производном классе, таком как OpenFileDialog или SaveFileDialog. (Унаследовано от FileDialog)
ShowDialog()	Отображает общее диалоговое окно. (Унаследовано от CommonDialog)
ShowDialog(Window)	Отображает общее диалоговое окно. (Унаследовано от CommonDialog)
ToString()	Возвращает строку, представляющую диалоговое окно открытия или сохранения файла. (Унаследовано от FileDialog)

События

FileOk

Возникает, когда пользователь выбирает имя файла, нажав кнопку Открыть в диалоговом окне OpenFileDialog или кнопку Сохранить в диалоговом окне SaveFileDialog. (Унаследовано от FileDialog)

См. также раздел

• OpenFileDialog