OpenFileDialog Klasse

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

OpenFileDialog.cs

Zeigt ein Standarddialogfeld an, in dem der Benutzer aufgefordert wird, eine Datei zu öffnen. Diese Klasse kann nicht vererbt werden.

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

Vererbung

Object

MarshalByRefObject

Component

CommonDialog

FileDialog

OpenFileDialog

Beispiele

Im folgenden Codebeispiel wird ein OpenFileDialog, mehrere Eigenschaften zum Definieren des Dateierweiterungsfilters und des Dialogfeldverhaltens festgelegt und das Dialogfeld mithilfe der CommonDialog.ShowDialog Methode angezeigt. Für das Beispiel ist ein Formular mit einem Button platzierten Formular und ein Verweis auf den System.IO diesem Namespace hinzugefügten Namespace erforderlich.

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

Hinweise

Mit dieser Klasse können Sie überprüfen, ob eine Datei vorhanden ist und ob sie geöffnet werden soll. Die ShowReadOnly Eigenschaft bestimmt, ob im Dialogfeld ein schreibgeschütztes Kontrollkästchen angezeigt wird. Die ReadOnlyChecked Eigenschaft gibt an, ob das schreibgeschützte Kontrollkästchen aktiviert ist.

Der Großteil der Kernfunktionen für diese Klasse befindet sich in der FileDialog Klasse.

Legen Sie auf einem Betriebssystem von rechts nach links die Eigenschaft des RightToLeft enthaltenden Formulars fest, um die Schaltflächen "Dateiname", "Öffnen" und "Abbrechen" des Dialogfelds zu RightToLeft.Yes lokalisieren. Wenn die Eigenschaft nicht auf RightToLeft.Yes festgelegt ist, wird stattdessen englischer Text verwendet.

Wenn Sie dem Benutzer die Möglichkeit geben möchten, einen Ordner anstelle einer Datei auszuwählen, verwenden Sie FolderBrowserDialog stattdessen.

Konstruktoren

Name	Beschreibung
OpenFileDialog()	Initialisiert eine Instanz der OpenFileDialog Klasse.

Eigenschaften

Name	Beschreibung
AddExtension	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld automatisch eine Erweiterung zu einem Dateinamen hinzufügt, wenn der Benutzer die Erweiterung ausgelassen. (Geerbt von FileDialog)
AddToRecent	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld die Datei hinzufügt, die geöffnet oder in der liste zuletzt gespeichert wird. (Geerbt von FileDialog)
AutoUpgradeEnabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob diese FileDialog Instanz die Darstellung und das Verhalten bei der Ausführung unter Windows Vista automatisch aktualisieren soll. (Geerbt von FileDialog)
CheckFileExists	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob im Dialogfeld eine Warnung angezeigt wird, wenn der Benutzer einen Dateinamen angibt, der nicht vorhanden ist.
CheckPathExists	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob im Dialogfeld eine Warnung angezeigt wird, wenn der Benutzer einen Pfad angibt, der nicht vorhanden ist. (Geerbt von FileDialog)
ClientGuid	Dient zum Abrufen oder Festlegen der GUID, die diesem Dialogfeldstatus zugeordnet werden soll. In der Regel wird der Status wie der zuletzt besuchte Ordner und die Position und Größe des Dialogfelds basierend auf dem Namen der ausführbaren Datei beibehalten. Durch Angeben einer GUID kann eine Anwendung unterschiedliche persistierte Zustände für verschiedene Versionen des Dialogfelds innerhalb derselben Anwendung aufweisen (z. B. ein Importdialogfeld und ein geöffnetes Dialogfeld). Diese Funktionalität ist nicht verfügbar, wenn eine Anwendung keine visuellen Formatvorlagen verwendet oder auf AutoUpgradeEnabled . festgelegt falseist. (Geerbt von FileDialog)
CustomPlaces	Ruft die Sammlung benutzerdefinierter Orte für diese FileDialog Instanz ab. (Geerbt von FileDialog)
DefaultExt	Dient zum Abrufen oder Festlegen der Standarddateierweiterung. (Geerbt von FileDialog)
DereferenceLinks	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld den Speicherort der Datei zurückgibt, auf die durch die Verknüpfung verwiesen wird, oder ob sie den Speicherort der Verknüpfung (.lnk) zurückgibt. (Geerbt von FileDialog)
FileName	Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den im Dialogfeld "Datei" ausgewählten Dateinamen enthält. (Geerbt von FileDialog)
FileNames	Ruft die Dateinamen aller ausgewählten Dateien im Dialogfeld ab. (Geerbt von FileDialog)
Filter	Dient zum Abrufen oder Festlegen der aktuellen Dateinamenfilterzeichenfolge, die die Optionen bestimmt, die im Feld "Dateityp speichern" oder "Dateityp" im Dialogfeld angezeigt werden. (Geerbt von FileDialog)
FilterIndex	Ruft den Index des filters ab, der derzeit im Dateidialogfeld ausgewählt ist, oder legt den Index fest. (Geerbt von FileDialog)
InitialDirectory	Ruft das anfängliche Verzeichnis ab, das im Dateidialogfeld angezeigt wird, oder legt dieses fest. (Geerbt von FileDialog)
Instance	Ruft das Win32-Instanzhandle für die Anwendung ab. (Geerbt von FileDialog)
Multiselect	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob im Dialogfeld mehrere Dateien ausgewählt werden können.
OkRequiresInteraction	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Schaltfläche "OK" des Dialogfelds deaktiviert ist, bis der Benutzer in der Ansicht navigiert oder den Dateinamen bearbeitet (falls zutreffend). (Geerbt von FileDialog)
Options	Ruft Werte zum Initialisieren der FileDialog. (Geerbt von FileDialog)
ReadOnlyChecked	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das schreibgeschützte Kontrollkästchen aktiviert ist.
RestoreDirectory	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld das Verzeichnis vor dem Schließen in das zuvor ausgewählte Verzeichnis wiederhergestellt. (Geerbt von FileDialog)
SafeFileName	Ruft den Dateinamen und die Erweiterung für die im Dialogfeld ausgewählte Datei ab. Der Dateiname enthält nicht den Pfad.
SafeFileNames	Ruft ein Array von Dateinamen und Erweiterungen für alle ausgewählten Dateien im Dialogfeld ab. Die Dateinamen enthalten nicht den Pfad.
SelectReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld die Auswahl schreibgeschützter Dateien zulässt.
ShowHelp	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Schaltfläche "Hilfe " im Dateidialogfeld angezeigt wird. (Geerbt von FileDialog)
ShowHiddenFiles	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob im Dialogfeld ausgeblendete und Systemdateien angezeigt werden. (Geerbt von FileDialog)
ShowPinnedPlaces	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die standardmäßig im Navigationsbereich der Ansicht angezeigten Elemente angezeigt werden. (Geerbt von FileDialog)
ShowPreview	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob im Dialogfeld eine Vorschau für ausgewählte Dateien angezeigt wird.
ShowReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld ein schreibgeschütztes Kontrollkästchen enthält.
SupportMultiDottedExtensions	Ruft ab oder legt fest, ob das Dialogfeld das Anzeigen und Speichern von Dateien mit mehreren Dateinamenerweiterungen unterstützt. (Geerbt von FileDialog)
Tag	Dient zum Abrufen oder Festlegen eines Objekts, das Daten zum Steuerelement enthält. (Geerbt von CommonDialog)
Title	Ruft den Titel des Dateidialogfelds ab oder legt den Titel fest. (Geerbt von FileDialog)
ValidateNames	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld nur gültige Win32-Dateinamen akzeptiert. (Geerbt von FileDialog)

Methoden

Name	Beschreibung
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die allgemeine Dialogfeld-Hook-Prozedur, die überschrieben wird, um dem Dateidialogfeld bestimmte Funktionen hinzuzufügen. (Geerbt von FileDialog)
OnFileOk(CancelEventArgs)	Löst das FileOk-Ereignis aus. (Geerbt von FileDialog)
OnHelpRequest(EventArgs)	Löst das HelpRequest-Ereignis aus. (Geerbt von CommonDialog)
OpenFile()	Öffnet die vom Benutzer ausgewählte Datei mit schreibgeschützter Berechtigung. Die Datei wird von der FileName Eigenschaft angegeben.
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Besitzerfensterprozedur, die überschrieben wird, um einem allgemeinen Dialogfeld bestimmte Funktionen hinzuzufügen. (Geerbt von CommonDialog)
Reset()	Setzt alle Eigenschaften auf ihre Standardwerte zurück.
RunDialog(IntPtr)	Gibt ein allgemeines Dialogfeld an. (Geerbt von FileDialog)
ShowDialog()	Führt ein allgemeines Dialogfeld mit einem Standardbesitzer aus. (Geerbt von CommonDialog)
ShowDialog(IWin32Window)	Führt ein allgemeines Dialogfeld mit dem angegebenen Besitzer aus. (Geerbt von CommonDialog)
ToString()	Stellt eine Zeichenfolgenversion dieses Objekts bereit. (Geerbt von FileDialog)

Ereignisse

Name	Beschreibung
FileOk	Tritt auf, wenn der Benutzer auf die Schaltfläche " Öffnen " oder " Speichern " in einem Dateidialogfeld klickt. (Geerbt von FileDialog)
HelpRequest	Tritt auf, wenn der Benutzer auf die Schaltfläche "Hilfe" in einem allgemeinen Dialogfeld klickt. (Geerbt von CommonDialog)

Weitere Informationen

• FileDialog
• CommonDialog
• SaveFileDialog
• Vorgehensweise: Lesen von Text aus einer Datei