OpenFileDialog Класс

Определение

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

Microsoft.Win32

Сборка:

PresentationFramework.dll

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

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

public sealed class OpenFileDialog : Microsoft.Win32.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

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

Object

CommonDialog

CommonItemDialog

FileDialog

OpenFileDialog

Примеры

В следующем примере показано, как создать OpenFileDialog объект , содержащий имя файла и тип расширения по умолчанию.

// Configure open file dialog box
Microsoft.Win32.OpenFileDialog dlg = new Microsoft.Win32.OpenFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show open file dialog box
Nullable<bool> result = dlg.ShowDialog();

// Process open file dialog box results
if (result == true)
{
    // Open document
    string filename = dlg.FileName;
}

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

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

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

Комментарии

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

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

OpenFileDialog()

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

Свойства

AddExtension	Получает или задает значение, указывающее, добавляет ли диалоговое окно открытия или сохранения файла расширение к имени файла автоматически, если пользователь опустил расширение. (Унаследовано от FileDialog)
AddToRecent	Возвращает или задает значение, указывающее, будет ли диалоговое окно добавлять открываемый или сохраненный элемент в список последних документов. (Унаследовано от CommonItemDialog)
CheckFileExists	Получает или задает значение, указывающее, отображает ли диалоговое окно открытия или сохранения файла предупреждение, если пользователь указал несуществующее имя файла. (Унаследовано от FileDialog)
CheckPathExists	Получает или задает значение, указывающее, отображается ли предупреждение, если пользователь вводит неверный путь или имя файла. (Унаследовано от FileDialog)
ClientGuid	Возвращает или задает GUID для связи с сохраненным состоянием диалогового окна. (Унаследовано от CommonItemDialog)
CustomPlaces	Получает или задает список настраиваемых расположений для диалоговых окон. (Унаследовано от FileDialog)
DefaultDirectory	Возвращает или задает каталог, отображаемый в диалоговом окне файла, если не доступно значение каталога, использованное в последнее время. (Унаследовано от CommonItemDialog)
DefaultExt	Получает или задает строковое значение, которое определяет расширение, используемое по умолчанию для фильтрации списка отображаемых файлов. (Унаследовано от FileDialog)
DereferenceLinks	Получает или задает значение, указывающее, что диалоговое окно возвращает местоположение файла, на который указывает ярлык, или местоположение файла ярлыка (LNK-файла). (Унаследовано от FileDialog)
FileName	Получает или задает строку, содержащую полный путь к файлу, выбранному в диалоговом окне открытия или сохранения файла. (Унаследовано от FileDialog)
FileNames	Получает массив, содержащий имена всех выбранных файлов. (Унаследовано от FileDialog)
Filter	Получает или задает строку фильтра, определяющую, какие типы файлов отображаются в диалоговом окне OpenFileDialog или SaveFileDialog. (Унаследовано от FileDialog)
FilterIndex	Получает или задает индекс фильтра, выбранного в настоящий момент в диалоговом окне открытия или сохранения файла. (Унаследовано от FileDialog)
ForcePreviewPane	Возвращает или задает флаг параметра, указывающий, включает ли диалоговое окно область предварительного просмотра.
InitialDirectory	Получает или задает начальный каталог, отображаемый диалоговым окном открытия или сохранения файла. (Унаследовано от FileDialog)
Multiselect	Получает или задает параметр, показывающий, позволяет ли диалоговое окно OpenFileDialog пользователям выбирать несколько файлов.
Options	Возвращает флаги общих диалоговых окон Win32, которые используются диалогами файлов для инициализации. (Унаследовано от FileDialog)
ReadOnlyChecked	Получает или задает значение, указывающее, установлен ли окном OpenFileDialog флажок "только чтение".
RestoreDirectory	Это свойство не реализовано. (Унаследовано от FileDialog)
RootDirectory	Возвращает или задает каталог, отображаемый в качестве корневого каталога навигации для диалогового окна. (Унаследовано от CommonItemDialog)
SafeFileName	Получает строку, содержащую только имя выбранного файла. (Унаследовано от FileDialog)
SafeFileNames	Получает массив, содержащий по одному безопасному имени для каждого выбранного файла. (Унаследовано от FileDialog)
ShowHiddenItems	Возвращает или задает значение, указывающее, будут ли в диалоговом окне отображаться скрытые и системные элементы независимо от предпочтений пользователя. (Унаследовано от CommonItemDialog)
ShowReadOnly	Получает или задает значение, указывающее, имеется ли в диалоговом окне OpenFileDialog флажок "только чтение".
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()	Открывает поток только на чтение для файла, выбранного пользователем с помощью диалогового окна OpenFileDialog.
OpenFiles()	Создает массив, содержащий один поток только для чтения для каждого файла, выбранного пользователем в диалоговом окне OpenFileDialog.
Reset()	Восстанавливает для всех свойств OpenFileDialog значения по умолчанию.
RunDialog(IntPtr)	RunDialog(IntPtr) вызывается для отображения диалогового окна открытия или сохранения файла в производном классе, таком как OpenFileDialog или SaveFileDialog. (Унаследовано от FileDialog)
ShowDialog()	Отображает общее диалоговое окно. (Унаследовано от CommonDialog)
ShowDialog(Window)	Отображает общее диалоговое окно. (Унаследовано от CommonDialog)
ToString()	Возвращает строку, представляющую диалоговое окно открытия или сохранения файла. (Унаследовано от FileDialog)

События

FileOk

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

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

• SaveFileDialog