OpenFileDialog Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

OpenFileDialog.cs

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

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 , чтобы RightToLeft.Yes локализовать имя файла диалогового окна, открыть и отменить кнопки. Если свойство не задано RightToLeft.Yes, вместо этого используется английский текст.

Если вы хотите предоставить пользователю возможность выбрать папку вместо файла, используйте FolderBrowserDialog ее.

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

Имя	Описание
OpenFileDialog()	Инициализирует экземпляр OpenFileDialog класса.

Свойства

Имя	Описание
AddExtension	Возвращает или задает значение, указывающее, добавляет ли диалоговое окно расширение в имя файла, если пользователь не указывает на расширение. (Унаследовано от FileDialog)
AddToRecent	Возвращает или задает значение, указывающее, добавляет ли диалоговое окно открываемый или сохраненный файл в последний список. (Унаследовано от FileDialog)
AutoUpgradeEnabled	Возвращает или задает значение, указывающее, должен ли этот FileDialog экземпляр автоматически обновлять внешний вид и поведение при запуске в Windows Vista. (Унаследовано от FileDialog)
CheckFileExists	Возвращает или задает значение, указывающее, отображается ли диалоговое окно предупреждение, если пользователь указывает имя файла, которое не существует.
CheckPathExists	Возвращает или задает значение, указывающее, отображается ли диалоговое окно предупреждение, если пользователь указывает путь, который не существует. (Унаследовано от FileDialog)
ClientGuid	Возвращает или задает GUID для связывания с этим состоянием диалогового окна. Как правило, состояние, например последняя посещенная папка и размер диалогового окна, сохраняется в зависимости от имени исполняемого файла. Указав GUID, приложение может иметь разные сохраняемые состояния для разных версий диалогового окна в одном приложении (например, диалоговое окно импорта и открытое диалоговое окно). Эта функция недоступна, если приложение не использует визуальные стили или AutoUpgradeEnabled если задано значение false. (Унаследовано от FileDialog)
CustomPlaces	Возвращает коллекцию настраиваемых мест для этого FileDialog экземпляра. (Унаследовано от FileDialog)
DefaultExt	Возвращает или задает расширение имени файла по умолчанию. (Унаследовано от FileDialog)
DereferenceLinks	Возвращает или задает значение, указывающее, возвращает ли диалоговое окно расположение файла, на который ссылается ярлык или возвращает расположение ярлыка (.lnk). (Унаследовано от FileDialog)
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	Возвращает или задает значение, указывающее, содержит ли диалоговое окно флажок только для чтения.
SupportMultiDottedExtensions	Возвращает или задает, поддерживает ли диалоговое окно отображение и сохранение файлов с несколькими расширениями имени файла. (Унаследовано от FileDialog)
Tag	Возвращает или задает объект, содержащий данные об элементе управления. (Унаследовано от CommonDialog)
Title	Возвращает или задает заголовок диалогового окна файла. (Унаследовано от FileDialog)
ValidateNames	Возвращает или задает значение, указывающее, принимает ли диалоговое окно только допустимые имена файлов Win32. (Унаследовано от FileDialog)

Методы

Имя	Описание
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Определяет общую процедуру перехватчика диалогового окна, переопределенную для добавления определенных функций в диалоговое окно файла. (Унаследовано от FileDialog)
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)

События

Имя	Описание
FileOk	Происходит, когда пользователь нажимает кнопку "Открыть " или " Сохранить " в диалоговом окне файла. (Унаследовано от FileDialog)
HelpRequest	Происходит, когда пользователь нажимает кнопку справки в общем диалоговом окне. (Унаследовано от CommonDialog)

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

• FileDialog
• CommonDialog
• SaveFileDialog
• Практическое руководство. Чтение текста из файла