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


OpenFileDialog Класс

Определение

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

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

Примеры

В следующем примере кода создается 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)

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

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