OpenFileDialog Klasa

Definicja

Namespace:

System.Windows.Forms

Montaż:

System.Windows.Forms.dll

Źródło:

OpenFileDialog.cs

Wyświetla standardowe okno dialogowe z monitem użytkownika o otwarcie pliku. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

OpenFileDialog

Przykłady

Poniższy przykład kodu tworzy element OpenFileDialog, ustawia kilka właściwości w celu zdefiniowania zachowania filtru rozszerzenia pliku i okna dialogowego, a następnie wyświetla okno dialogowe przy użyciu CommonDialog.ShowDialog metody . Przykład wymaga formularza umieszczonego Button na nim i odwołania do dodanej System.IO do niej przestrzeni nazw.

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

Uwagi

Ta klasa umożliwia sprawdzenie, czy plik istnieje i czy go otworzyć. Właściwość ShowReadOnly określa, czy pole wyboru tylko do odczytu jest wyświetlane w oknie dialogowym. Właściwość ReadOnlyChecked wskazuje, czy pole wyboru tylko do odczytu jest zaznaczone.

Większość podstawowych funkcji tej klasy znajduje się w FileDialog klasie.

W systemie operacyjnym od prawej do lewej ustaw właściwość formularza zawierająca RightToLeft , aby RightToLeft.Yes lokalizować ustawienia nazwy pliku okna dialogowego, Otwórz i Anuluj . Jeśli właściwość nie jest ustawiona na RightToLeft.Yes, zamiast tego jest używany tekst angielski.

Jeśli chcesz dać użytkownikowi możliwość wybrania folderu zamiast pliku, użyj FolderBrowserDialog zamiast tego.

Konstruktorów

Nazwa	Opis
OpenFileDialog()	Inicjuje wystąpienie klasy OpenFileDialog.

Właściwości

Nazwa	Opis
AddExtension	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe automatycznie dodaje rozszerzenie do nazwy pliku, jeśli użytkownik pomija rozszerzenie. (Dziedziczone od FileDialog)
AddToRecent	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe dodaje otwierany lub zapisywany plik na najnowszej liście. (Dziedziczone od FileDialog)
AutoUpgradeEnabled	Pobiera lub ustawia wartość wskazującą, czy to FileDialog wystąpienie powinno automatycznie uaktualniać wygląd i zachowanie podczas uruchamiania w systemie Windows Vista. (Dziedziczone od FileDialog)
CheckFileExists	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla ostrzeżenie, jeśli użytkownik określa nazwę pliku, która nie istnieje.
CheckPathExists	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla ostrzeżenie, jeśli użytkownik określa ścieżkę, która nie istnieje. (Dziedziczone od FileDialog)
ClientGuid	Pobiera lub ustawia identyfikator GUID do skojarzenia z tym stanem okna dialogowego. Zazwyczaj stan, taki jak ostatni odwiedzony folder i położenie i rozmiar okna dialogowego, są utrwalane na podstawie nazwy pliku wykonywalnego. Określając identyfikator GUID, aplikacja może mieć różne stany utrwalone dla różnych wersji okna dialogowego w tej samej aplikacji (na przykład okno dialogowe importowania i otwarte okno dialogowe). Ta funkcja nie jest dostępna, jeśli aplikacja nie używa stylów wizualnych lub jeśli AutoUpgradeEnabled jest ustawiona na falsewartość . (Dziedziczone od FileDialog)
CustomPlaces	Pobiera kolekcję miejsc niestandardowych dla tego FileDialog wystąpienia. (Dziedziczone od FileDialog)
DefaultExt	Pobiera lub ustawia domyślne rozszerzenie nazwy pliku. (Dziedziczone od FileDialog)
DereferenceLinks	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe zwraca lokalizację pliku, do których odwołuje się skrót, czy też zwraca lokalizację skrótu (lnk). (Dziedziczone od FileDialog)
FileName	Pobiera lub ustawia ciąg zawierający nazwę pliku wybraną w oknie dialogowym pliku. (Dziedziczone od FileDialog)
FileNames	Pobiera nazwy plików wszystkich wybranych plików w oknie dialogowym. (Dziedziczone od FileDialog)
Filter	Pobiera lub ustawia bieżący ciąg filtru nazwy pliku, który określa opcje wyświetlane w oknie dialogowym "Zapisz jako typ pliku" lub "Pliki typu". (Dziedziczone od FileDialog)
FilterIndex	Pobiera lub ustawia indeks filtru aktualnie wybranego w oknie dialogowym pliku. (Dziedziczone od FileDialog)
InitialDirectory	Pobiera lub ustawia początkowy katalog wyświetlany przez okno dialogowe pliku. (Dziedziczone od FileDialog)
Instance	Pobiera dojście wystąpienia Win32 dla aplikacji. (Dziedziczone od FileDialog)
Multiselect	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe umożliwia wybranie wielu plików.
OkRequiresInteraction	Pobiera lub ustawia wartość wskazującą, czy przycisk OK okna dialogowego jest wyłączony, dopóki użytkownik nie przejdzie do widoku lub edytuje nazwę pliku (jeśli ma to zastosowanie). (Dziedziczone od FileDialog)
Options	Pobiera wartości w celu zainicjowania elementu FileDialog. (Dziedziczone od FileDialog)
ReadOnlyChecked	Pobiera lub ustawia wartość wskazującą, czy zaznaczono pole wyboru tylko do odczytu.
RestoreDirectory	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe przywraca katalog do wcześniej wybranego katalogu przed zamknięciem. (Dziedziczone od FileDialog)
SafeFileName	Pobiera nazwę i rozszerzenie pliku wybranego w oknie dialogowym. Nazwa pliku nie zawiera ścieżki.
SafeFileNames	Pobiera tablicę nazw plików i rozszerzeń dla wszystkich wybranych plików w oknie dialogowym. Nazwy plików nie zawierają ścieżki.
SelectReadOnly	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe zezwala na wybór plików tylko do odczytu.
ShowHelp	Pobiera lub ustawia wartość wskazującą, czy przycisk Pomoc jest wyświetlany w oknie dialogowym pliku. (Dziedziczone od FileDialog)
ShowHiddenFiles	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla ukryte i systemowe pliki. (Dziedziczone od FileDialog)
ShowPinnedPlaces	Pobiera lub ustawia wartość wskazującą, czy elementy wyświetlane domyślnie w okienku nawigacji widoku są wyświetlane. (Dziedziczone od FileDialog)
ShowPreview	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla podgląd wybranych plików.
ShowReadOnly	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe zawiera pole wyboru tylko do odczytu.
SupportMultiDottedExtensions	Pobiera lub ustawia, czy okno dialogowe obsługuje wyświetlanie i zapisywanie plików z wieloma rozszerzeniami nazw plików. (Dziedziczone od FileDialog)
Tag	Pobiera lub ustawia obiekt zawierający dane dotyczące kontrolki. (Dziedziczone od CommonDialog)
Title	Pobiera lub ustawia tytuł okna dialogowego pliku. (Dziedziczone od FileDialog)
ValidateNames	Pobiera lub ustawia wartość wskazującą, czy okno dialogowe akceptuje tylko prawidłowe nazwy plików Win32. (Dziedziczone od FileDialog)

Metody

Nazwa	Opis
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje wspólną procedurę zaczepienia okna dialogowego, która jest zastępowana w celu dodania określonych funkcji do okna dialogowego pliku. (Dziedziczone od FileDialog)
OnFileOk(CancelEventArgs)	FileOk Zgłasza zdarzenie. (Dziedziczone od FileDialog)
OnHelpRequest(EventArgs)	HelpRequest Zgłasza zdarzenie. (Dziedziczone od CommonDialog)
OpenFile()	Otwiera plik wybrany przez użytkownika z uprawnieniem tylko do odczytu. Plik jest określony przez FileName właściwość .
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiuje procedurę okna właściciela, która jest zastępowana, aby dodać określone funkcje do wspólnego okna dialogowego. (Dziedziczone od CommonDialog)
Reset()	Resetuje wszystkie właściwości do ich wartości domyślnych.
RunDialog(IntPtr)	Określa typowe okno dialogowe. (Dziedziczone od FileDialog)
ShowDialog()	Uruchamia wspólne okno dialogowe z domyślnym właścicielem. (Dziedziczone od CommonDialog)
ShowDialog(IWin32Window)	Uruchamia wspólne okno dialogowe z określonym właścicielem. (Dziedziczone od CommonDialog)
ToString()	Udostępnia wersję ciągu tego obiektu. (Dziedziczone od FileDialog)

Zdarzenia

Nazwa	Opis
FileOk	Występuje, gdy użytkownik kliknie przycisk Otwórz lub Zapisz w oknie dialogowym plik. (Dziedziczone od FileDialog)
HelpRequest	Występuje, gdy użytkownik kliknie przycisk Pomoc w typowym oknie dialogowym. (Dziedziczone od CommonDialog)

Zobacz także

• FileDialog
• CommonDialog
• SaveFileDialog
• Instrukcje: Odczytywanie tekstu z pliku