Поделиться через


SaveFileDialog Класс

Определение

Представляет общее диалоговое окно, позволяющее пользователю задать имя файла, чтобы сохранить файл под другим именем. Объект 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
Наследование
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)

Применяется к

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