OpenFileDialog Класс

Ссылка

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Важно!

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

Отображает диалоговое окно, позволяющее пользователю открыть файл. Этот класс не наследуется.

public ref class OpenFileDialog sealed : System::Windows::Forms::FileDialog

public sealed class OpenFileDialog : System.Windows.Forms.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

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

MarshalByRefObject

Component

CommonDialog

FileDialog
OpenFileDialog

Примеры

В следующем примере кода создается 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 задано значение `false`. (Унаследовано от FileDialog)
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)

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

OpenFileDialog Класс

Определение

Примеры

Комментарии

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

Свойства

Методы

События

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

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

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

Дополнительные ресурсы