FileDialog Класс

Определение

Абстрактный базовый класс, который инкапсулирует функциональные возможности, общие для диалоговых окон работы с файлами, включая OpenFileDialog и SaveFileDialog.An abstract base class that encapsulates functionality that is common to file dialogs, including OpenFileDialog and SaveFileDialog.

public ref class FileDialog abstract : Microsoft::Win32::CommonDialog
public abstract class FileDialog : Microsoft.Win32.CommonDialog
type FileDialog = class
    inherit CommonDialog
Public MustInherit Class FileDialog
Inherits CommonDialog
Наследование
FileDialog
Производный

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

FileDialog()

Инициализирует новый экземпляр класса FileDialog.Initializes a new instance of the FileDialog class.

Свойства

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.

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.

CheckPathExists

Получает или задает значение, указывающее, отображается ли предупреждение, если пользователь вводит неверный путь или имя файла.Gets or sets a value that specifies whether warnings are displayed if the user types invalid paths and file names.

CustomPlaces

Получает или задает список настраиваемых расположений для диалоговых окон.Gets or sets the list of custom places for file dialog boxes.

DefaultExt

Получает или задает строковое значение, которое определяет расширение, используемое по умолчанию для фильтрации списка отображаемых файлов.Gets or sets a value that specifies the default extension string to use to filter the list of files that are displayed.

DereferenceLinks

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

FileName

Получает или задает строку, содержащую полный путь к файлу, выбранному в диалоговом окне открытия или сохранения файла.Gets or sets a string containing the full path of the file selected in a file dialog.

FileNames

Получает массив, содержащий имена всех выбранных файлов.Gets an array that contains one file name for each selected file.

Filter

Получает или задает строку фильтра, определяющую, какие типы файлов отображаются в диалоговом окне OpenFileDialog или SaveFileDialog.Gets or sets the filter string that determines what types of files are displayed from either the OpenFileDialog or SaveFileDialog.

FilterIndex

Возвращает или задает индекс фильтра, выбранного в настоящий момент в диалоговом окне открытия или сохранения файла.Gets or sets the index of the filter currently selected in a file dialog.

InitialDirectory

Возвращает или задает начальный каталог, отображенный диалоговым окном открытия или сохранения файла.Gets or sets the initial directory that is displayed by a file dialog.

Options

Получает флаги стандартного диалогового окна открытия или сохранения файлов Win32Win32, используемые этими диалоговыми окнами для инициализации.Gets the Win32Win32 common file dialog flags that are used by file dialogs for initialization.

RestoreDirectory

Это свойство не реализовано.This property is not implemented.

SafeFileName

Получает строку, содержащую только имя выбранного файла.Gets a string that only contains the file name for the selected file.

SafeFileNames

Получает массив, содержащий по одному безопасному имени для каждого выбранного файла.Gets an array that contains one safe file name for each selected file.

Tag

Получает или задает объект, связанный с диалоговым окном.Gets or sets an object associated with the dialog. Таким образом, обеспечивает возможность присоединить к диалоговому окну произвольный объект.This provides the ability to attach an arbitrary object to the dialog.

(Унаследовано от CommonDialog)
Title

Возвращает или задает текст строки заголовка диалогового окна открытия или сохранения файла.Gets or sets the text that appears in the title bar of a file dialog.

ValidateNames

Получает или задает значение, указывающее, принимает ли диалоговое окно только допустимые имена файлов Win32Win32.Gets or sets a value indicating whether the dialog accepts only valid Win32Win32 file names.

Методы

CheckPermissionsToShowDialog()

Определяет, достаточны ли разрешения для отображения диалогового окна.Determines whether sufficient permissions for displaying a dialog exist.

(Унаследовано от CommonDialog)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Определяет процедуру обработки стандартного диалогового окна открытия или сохранения файла, переопределенную для добавления в окно стандартной функциональности.Defines the common file dialog hook procedure that is overridden to add common functionality to a file dialog.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnFileOk(CancelEventArgs)

Вызывает событие FileOk.Raises the FileOk event.

Reset()

Присваивает всем свойствам диалогового окна открытия или сохранения файла исходные значения.Sets all properties of a file dialog back to their initial values.

RunDialog(IntPtr)

RunDialog(IntPtr) вызывается для отображения диалогового окна открытия или сохранения файла в производном классе, таком как OpenFileDialog или SaveFileDialog.RunDialog(IntPtr) is called to display a file dialog in a derived class, such as OpenFileDialog and SaveFileDialog.

ShowDialog()

Отображает общее диалоговое окно.Displays a common dialog.

(Унаследовано от CommonDialog)
ShowDialog(Window)

Отображает общее диалоговое окно.Displays a common dialog.

(Унаследовано от CommonDialog)
ToString()

Возвращает строку, представляющую диалоговое окно открытия или сохранения файла.Returns a string that represents a file dialog.

События

FileOk

Возникает, когда пользователь выбирает имя файла, нажав кнопку Открыть в диалоговом окне OpenFileDialog или кнопку Сохранить в диалоговом окне SaveFileDialog.Occurs when the user selects a file name by either clicking the Open button of the OpenFileDialog or the Save button of the SaveFileDialog.

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