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.Value)
{
    // 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	Возвращает или задает значение, указывающее, будет ли диалоговое окно пытаться создать тестовый файл по выбранному пути.
DefaultDirectory	Возвращает или задает каталог, отображаемый диалоговым окном файла, если не доступно значение каталога, которое недавно использовалось. (Унаследовано от CommonItemDialog)
DefaultExt	Возвращает или задает значение, указывающее строку расширения по умолчанию для фильтрации списка отображаемых файлов. (Унаследовано от FileDialog)
FileName	Возвращает или задает строку, содержащую полный путь к файлу, выбранному в диалоговом окне файла. (Унаследовано от FileDialog)
FileNames	Получает массив, содержащий одно имя файла для каждого выбранного файла. (Унаследовано от FileDialog)
Filter	Возвращает или задает строку фильтра, которая определяет, какие типы файлов отображаются из либо OpenFileDialogSaveFileDialog. (Унаследовано от FileDialog)
FilterIndex	Возвращает или задает индекс фильтра, выбранного в диалоговом окне файла. (Унаследовано от FileDialog)
OverwritePrompt	Возвращает или задает значение, указывающее, отображается ли SaveFileDialog предупреждение, если пользователь указывает имя файла, который уже существует.
RestoreDirectory	Это свойство не реализовано. (Унаследовано от FileDialog)
RootDirectory	Возвращает или задает каталог, отображаемый в качестве корневого каталога навигации для диалогового окна. (Унаследовано от CommonItemDialog)
SafeFileName	Возвращает строку, содержащую только имя файла для выбранного файла. (Унаследовано от FileDialog)
SafeFileNames	Получает массив, содержащий одно безопасное имя файла для каждого выбранного файла. (Унаследовано от FileDialog)
ShowHiddenItems	Возвращает или задает значение, указывающее, будет ли диалоговое окно отображать скрытые и системные элементы независимо от настроек пользователя. (Унаследовано от CommonItemDialog)
Tag	Возвращает или задает объект, связанный с диалогом. Это обеспечивает возможность подключения произвольного объекта к диалогу. (Унаследовано от CommonDialog)

Методы

Имя	Описание
CheckPermissionsToShowDialog()	Определяет, существуют ли достаточные разрешения для отображения диалогового окна. (Унаследовано от CommonDialog)
OnItemOk(CancelEventArgs)	Вызывает событие FileOk. (Унаследовано от FileDialog)
OpenFile()	Создает поток файлов чтения и записи для имени файла, выбранного пользователем.SaveFileDialog
Reset()	Сбрасывает все SaveFileDialog свойства в значения по умолчанию.
ShowDialog()	Отображает общее диалоговое окно. (Унаследовано от CommonDialog)
ShowDialog(Window)	Отображает общее диалоговое окно. (Унаследовано от CommonDialog)
ToString()	Возвращает строку, представляющую диалоговое окно файла. (Унаследовано от FileDialog)

События

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

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

• OpenFileDialog