OpenFileDialog Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Отображает диалоговое окно, позволяющее пользователю открыть файл. Этот класс не наследуется.
public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialogpublic sealed class OpenFileDialog : System.Windows.Forms.FileDialogtype OpenFileDialog = class
inherit FileDialogPublic NotInheritable Class OpenFileDialog
Inherits FileDialog- Наследование
Примеры
В следующем примере кода создается OpenFileDialog, задает несколько свойств, определяющих фильтр расширений файлов и поведение диалога, и отображает диалоговое окно с помощью CommonDialog.ShowDialog метода . В этом примере требуется форма с размещенным Button на ней элементом и ссылкой на System.IO пространство имен, добавленное в него.
private:
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
Stream^ myStream;
OpenFileDialog^ openFileDialog1 = gcnew OpenFileDialog;
openFileDialog1->InitialDirectory = "c:\\";
openFileDialog1->Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
openFileDialog1->FilterIndex = 2;
openFileDialog1->RestoreDirectory = true;
if ( openFileDialog1->ShowDialog() == System::Windows::Forms::DialogResult::OK )
{
if ( (myStream = openFileDialog1->OpenFile()) != nullptr )
{
// Insert code to read the stream here.
myStream->Close();
}
}
}
var fileContent = string.Empty;
var filePath = string.Empty;
using (OpenFileDialog openFileDialog = new OpenFileDialog())
{
openFileDialog.InitialDirectory = "c:\\";
openFileDialog.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*";
openFileDialog.FilterIndex = 2;
openFileDialog.RestoreDirectory = true;
if (openFileDialog.ShowDialog() == DialogResult.OK)
{
//Get the path of specified file
filePath = openFileDialog.FileName;
//Read the contents of the file into a stream
var fileStream = openFileDialog.OpenFile();
using (StreamReader reader = new StreamReader(fileStream))
{
fileContent = reader.ReadToEnd();
}
}
}
MessageBox.Show(fileContent, "File Content at path: " + filePath, MessageBoxButtons.OK);
Private Sub button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
Dim myStream As Stream = Nothing
Dim openFileDialog1 As New OpenFileDialog()
openFileDialog1.InitialDirectory = "c:\"
openFileDialog1.Filter = "txt files (*.txt)|*.txt|All files (*.*)|*.*"
openFileDialog1.FilterIndex = 2
openFileDialog1.RestoreDirectory = True
If openFileDialog1.ShowDialog() = System.Windows.Forms.DialogResult.OK Then
Try
myStream = openFileDialog1.OpenFile()
If (myStream IsNot Nothing) Then
' Insert code to read the stream here.
End If
Catch Ex As Exception
MessageBox.Show("Cannot read file from disk. Original error: " & Ex.Message)
Finally
' Check this again, since we need to make sure we didn't throw an exception on open.
If (myStream IsNot Nothing) Then
myStream.Close()
End If
End Try
End If
End Sub
Комментарии
Этот класс позволяет проверка, существует ли файл, и открыть его. Свойство ShowReadOnly определяет, отображается ли в диалоговом окне поле проверка только для чтения. Свойство ReadOnlyChecked указывает, установлен ли флажок проверка только для чтения.
Большая часть основных функциональных возможностей этого класса находится в FileDialog классе .
В операционной системе справа налево для свойства RightToLeft.Yes содержащей формы RightToLeft локализуются кнопки Имя файла, Открыть и Отмена диалогового окна. Если для свойства не задано значение RightToLeft.Yes, вместо него используется текст на английском языке.
Если вы хотите предоставить пользователю возможность выбрать папку, а не файл, используйте FolderBrowserDialog вместо него.
Конструкторы
| OpenFileDialog() |
Инициализирует экземпляр класса OpenFileDialog. |
Свойства
| AddExtension |
Возвращает или задает значение, определяющее, добавляет ли автоматически диалоговое окно расширение к имени файла, если пользователь опускает данное расширение. (Унаследовано от FileDialog) |
| AddToRecent |
Возвращает или задает значение, указывающее, добавляет ли диалоговое окно открываемый или сохраненный файл в список последних. (Унаследовано от FileDialog) |
| AutoUpgradeEnabled |
Возвращает или задает значение, указывающее, должен ли этот FileDialog экземпляр автоматически обновлять внешний вид и поведение при работе в Windows Vista. (Унаследовано от FileDialog) |
| CanRaiseEvents |
Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component) |
| CheckFileExists |
Возвращает или задает значение, указывающее, отображается ли в диалоговом окне предупреждение, если пользователь указывает несуществующее имя файла. |
| CheckPathExists |
Возвращает или задает значение, указывающее, отображает ли диалоговое окно предупреждение, если пользователь указывает несуществующий путь. (Унаследовано от FileDialog) |
| ClientGuid |
Получает или задает GUID, связываемый с этим состоянием диалога. Как правило, состояние, такое как последняя посещенная папка, а также расположение и размер диалогового окна, сохраняется с учетом имени исполняемого файла. При указании GUID приложение может иметь разные сохраняемые состояния для разных версий диалогового окна в том же приложении (например, диалоговое окно импорта и диалоговое окно открытия). Эта функция недоступна, если приложение не использует стили оформления или если для AutoUpgradeEnabled задано значение |
| Container |
Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component) |
| CustomPlaces |
Получает коллекцию пользовательских размещений для этого экземпляра FileDialog. (Унаследовано от FileDialog) |
| DefaultExt |
Возвращает или задает расширение имени файла по умолчанию. (Унаследовано от FileDialog) |
| DereferenceLinks |
Возвращает или задает значение, указывающее, возвращает ли диалоговое окно расположение файла, представленного ярлыком, или возвращает расположение самого ярлыка (.lnk). (Унаследовано от FileDialog) |
| DesignMode |
Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component) |
| Events |
Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component) |
| FileName |
Возвращает или задает строку, содержащую имя файла, выбранного в диалоговом окне. (Унаследовано от FileDialog) |
| FileNames |
Возвращает имена всех выбранных файлов в диалоговом окне. (Унаследовано от FileDialog) |
| Filter |
Возвращает или задает текущую строку фильтра имен файлов, которая определяет варианты, доступные в поле диалогового окна "Сохранить как файл типа" или "Файлы типа". (Унаследовано от FileDialog) |
| FilterIndex |
Возвращает или задает индекс фильтра, выбранного в настоящий момент в диалоговом окне файла. (Унаследовано от FileDialog) |
| InitialDirectory |
Возвращает или задает начальную папку, отображенную диалоговым окном файла. (Унаследовано от FileDialog) |
| Instance |
Возвращает дескриптор экземпляра обработчика Win32 для приложения. (Унаследовано от FileDialog) |
| Multiselect |
Получает или задает значение, указывающее, можно ли в диалоговом окне выбирать несколько файлов. |
| OkRequiresInteraction |
Возвращает или задает значение, указывающее, отключена ли кнопка ОК диалогового окна, пока пользователь не перейдет по представлению или не изменит имя файла (если применимо). (Унаследовано от FileDialog) |
| Options |
Получает значения для инициализации класса FileDialog. (Унаследовано от FileDialog) |
| ReadOnlyChecked |
Получает или задает значение, указывающее, установлен ли флажок доступности только для чтения. |
| RestoreDirectory |
Получает или задает значение, указывающее, восстанавливает ли диалоговое окно ранее выбранный каталог в качестве текущего каталога перед закрытием. (Унаследовано от FileDialog) |
| SafeFileName |
Возвращает имя и расширение файла, выбранного в диалоговом окне. Имя файла не включает сведения о пути. |
| SafeFileNames |
Возвращает массив имен и расширений файлов для всех выбранных в диалоговом окне файлов. Имена файлов не включают сведений о пути. |
| SelectReadOnly |
Возвращает или задает значение, указывающее, разрешено ли в диалоговом окне выбирать файлы, доступные только для чтения. |
| ShowHelp |
Возвращает или задает значение, определяющее, отображается ли кнопка Справка в диалоговом окне работы с файлами. (Унаследовано от FileDialog) |
| ShowHiddenFiles |
Возвращает или задает значение, указывающее, отображаются ли в диалоговом окне скрытые и системные файлы. (Унаследовано от FileDialog) |
| ShowPinnedPlaces |
Возвращает или задает значение, указывающее, отображаются ли элементы, отображаемые по умолчанию в области навигации представления. (Унаследовано от FileDialog) |
| ShowPreview |
Возвращает или задает значение, указывающее, отображается ли в диалоговом окне предварительный просмотр выбранных файлов. |
| ShowReadOnly |
Получает или задает значение, указывающее, имеется ли в диалоговом окне флажок "доступно только для чтения". |
| Site |
Получает или задает ISite объекта Component. (Унаследовано от Component) |
| SupportMultiDottedExtensions |
Возвращает или задает значение, определяющее, поддерживает ли диалоговое окно отображение и сохранение файлов, которые содержат несколько расширений имени. (Унаследовано от FileDialog) |
| Tag |
Получает или задает объект, содержащий данные элемента управления. (Унаследовано от CommonDialog) |
| Title |
Возвращает или задает заголовок диалогового окна файла. (Унаследовано от FileDialog) |
| ValidateNames |
Возвращает или задает значение, указывающее, принимает ли диалоговое окно только допустимые имена файлов Win32. (Унаследовано от FileDialog) |
Методы
| CreateObjRef(Type) |
Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
| Dispose() |
Освобождает все ресурсы, занятые модулем Component. (Унаследовано от Component) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от Component) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetLifetimeService() |
Устаревшие..
Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject) |
| GetService(Type) |
Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component) |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Определяет процедуру обработки общего диалогового окна, переопределенную, чтобы добавить специальные функции в диалоговое окно файла. (Унаследовано от FileDialog) |
| InitializeLifetimeService() |
Устаревшие..
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| MemberwiseClone(Boolean) |
Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject) |
| OnFileOk(CancelEventArgs) |
Вызывает событие FileOk. (Унаследовано от FileDialog) |
| OnHelpRequest(EventArgs) |
Вызывает событие HelpRequest. (Унаследовано от CommonDialog) |
| OpenFile() |
Открывает выбранный пользователем файл в режиме "только чтение". Файл задается свойством FileName. |
| OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr) |
Определяет процедуру окна-владельца, которая переопределяется, чтобы добавить специальные функции для общего диалогового окна. (Унаследовано от CommonDialog) |
| Reset() |
Восстанавливает заданные по умолчанию значения всех свойств. |
| RunDialog(IntPtr) |
Указывает общее диалоговое окно. (Унаследовано от FileDialog) |
| ShowDialog() |
Запускает общее диалоговое окно с заданным по умолчанию владельцем. (Унаследовано от CommonDialog) |
| ShowDialog(IWin32Window) |
Запускает общее диалоговое окно с указанным владельцем. (Унаследовано от CommonDialog) |
| ToString() |
Представляет строковую версию этого объекта. (Унаследовано от FileDialog) |
События
| Disposed |
Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component) |
| FileOk |
Происходит при нажатии пользователем кнопки Открыть или Сохранить в диалоговом окне файла. (Унаследовано от FileDialog) |
| HelpRequest |
Происходит при нажатии пользователем кнопки справки в общем диалоговом окне. (Унаследовано от CommonDialog) |
