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

FileDialog
OpenFileDialog

Наследование: 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.Value)
{
    // 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

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

Имя	Описание
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

Обратная связь

Были ли сведения на этой странице полезными?