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


OpenFileDialog Класс

Определение

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

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
Наследование
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)

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

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