Freigeben über


OpenFileDialog Klasse

Definition

Zeigt ein Standarddialogfeld an, das den Benutzer zum Öffnen einer Datei auffordert. 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

Beispiele

Im folgenden Codebeispiel wird ein OpenFileDialogerstellt, mehrere Eigenschaften festgelegt, um den Dateierweiterungsfilter und das Dialogfeldverhalten zu definieren, und zeigt das Dialogfeld mithilfe der CommonDialog.ShowDialog -Methode an. Das Beispiel erfordert ein Formular mit einem Button darauf platzierten und einem Verweis auf den Namespace, der System.IO diesem hinzugefügt wurde.

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 sie öffnen. 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.

Bei einem Betriebssystem von rechts nach links werden die Schaltflächen Dateiname, Öffnen und Abbrechen im Dialogfeld durch Festlegen der -Eigenschaft des RightToLeft enthaltenden Formulars auf RightToLeft.Yes lokalisiert. Wenn die -Eigenschaft nicht auf RightToLeft.Yesfestgelegt 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

OpenFileDialog()

Initialisiert eine Instanz der OpenFileDialog-Klasse.

Eigenschaften

AddExtension

Ruft einen Wert ab, der angibt, ob einem Dateinamen im Dialogfeld automatisch eine Erweiterung hinzugefügt wird, wenn der Benutzer keine Erweiterung angibt, oder legt diesen Wert fest.

(Geerbt von FileDialog)
AddToRecent

Ruft einen Wert ab, der angibt, ob das Dialogfeld die datei hinzufügt, die geöffnet oder gespeichert wird, der Zuletzt verwendeten Liste.

(Geerbt von FileDialog)
AutoUpgradeEnabled

Ruft einen Wert ab, der angibt, ob dieses FileDialog instance bei der Ausführung unter Windows Vista automatisch das Aussehen und Verhalten aktualisieren soll, oder legt diesen fest.

(Geerbt von FileDialog)
CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.

(Geerbt von Component)
CheckFileExists

Ruft einen Wert ab, der angibt, ob im Dialogfeld eine Warnung angezeigt wird, wenn der Benutzer den Namen einer nicht vorhandenen Datei angibt, oder legt diesen fest.

CheckPathExists

Ruft einen Wert ab, der angibt, ob im Dialogfeld eine Warnung angezeigt wird, wenn der Benutzer einen nicht vorhandenen Pfad angibt, oder legt diesen fest.

(Geerbt von FileDialog)
ClientGuid

Ruft die GUID ab, die diesem Dialogfeldzustand zugeordnet werden soll, oder legt sie fest. In der Regel wird der Zustand, z. B. 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 beibehaltene Zustände für verschiedene Versionen des Dialogfelds innerhalb derselben Anwendung aufweisen (z. B. ein Dialogfeld zum Importieren und ein Dialogfeld zum Öffnen).

Diese Funktion ist nicht verfügbar, wenn eine Anwendung keine visuellen Stile verwendet oder wenn AutoUpgradeEnabled auf false festgelegt ist.

(Geerbt von FileDialog)
Container

Ruft die IContainer ab, die in der Component enthalten ist.

(Geerbt von Component)
CustomPlaces

Ruft die Auflistung der benutzerdefinierten Speicherorte für diese FileDialog-Instanz ab.

(Geerbt von FileDialog)
DefaultExt

Ruft die Standarddateinamenerweiterung ab oder legt diese fest.

(Geerbt von FileDialog)
DereferenceLinks

Ruft einen Wert ab, der angibt, ob das Dialogfeld den Speicherort der Datei, auf die die Verknüpfung verweist, oder den Speicherort der Verknüpfung (.lnk) zurückgibt, oder legt diesen Wert fest.

(Geerbt von FileDialog)
DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.

(Geerbt von Component)
Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.

(Geerbt von Component)
FileName

Ruft eine Zeichenfolge ab, die den im Dateidialogfeld ausgewählten Dateinamen enthält, oder legt diese fest.

(Geerbt von FileDialog)
FileNames

Ruft die Dateinamen aller im Dialogfeld ausgewählten Dateien ab.

(Geerbt von FileDialog)
Filter

Ruft die aktuelle Filterzeichenfolge für Dateinamen ab, die die im Dialogfeld im Feld „Speichern unter“ oder „Dateityp“ angezeigte Auswahl bestimmt, oder legt diese fest.

(Geerbt von FileDialog)
FilterIndex

Ruft den Index des derzeit im Dateidialogfeld ausgewählten Filters ab oder legt diesen Index fest.

(Geerbt von FileDialog)
InitialDirectory

Ruft das Ausgangsverzeichnis 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

Ruft einen Wert ab, der angibt, ob im Dialogfeld mehrere Dateien ausgewählt werden können, oder legt diesen fest.

OkRequiresInteraction

Ruft einen Wert ab, 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 für die Initialisierung von FileDialog ab.

(Geerbt von FileDialog)
ReadOnlyChecked

Ruft einen Wert ab, der angibt, ob das Kontrollkästchen für den Schreibschutz aktiviert ist, oder legt diesen fest.

RestoreDirectory

Ruft einen Wert ab oder legt diesen fest, der angibt, ob das Dialogfeld das Verzeichnis im zuvor ausgewählten Verzeichnis vor dem Schließen wiederherstellt.

(Geerbt von FileDialog)
SafeFileName

Ruft den Dateinamen und die Erweiterung für die im Dialogfeld ausgewählte Datei ab. Der Dateiname enthält keine Pfadangabe.

SafeFileNames

Ruft ein Array von Dateinamen und Erweiterungen für alle ausgewählten Dateien im Dialogfeld ab. Die Dateinamen enthalten keine Pfadangaben.

SelectReadOnly

Ruft einen Wert ab, der angibt, ob das Dialogfeld die Auswahl schreibgeschützter Dateien zulässt, oder legt den Wert fest.

ShowHelp

Ruft einen Wert ab, der angibt, ob im Dateidialogfeld die Schaltfläche Hilfe angezeigt wird, oder legt diesen Wert fest.

(Geerbt von FileDialog)
ShowHiddenFiles

Ruft einen Wert ab, der angibt, ob im Dialogfeld ausgeblendete Und Systemdateien angezeigt werden, oder legt den Wert fest.

(Geerbt von FileDialog)
ShowPinnedPlaces

Ruft einen Wert ab, der angibt, ob die standardmäßig im Navigationsbereich der Ansicht angezeigten Elemente angezeigt werden, oder legt einen Wert fest.

(Geerbt von FileDialog)
ShowPreview

Ruft einen Wert ab, der angibt, ob das Dialogfeld eine Vorschau für ausgewählte Dateien anzeigt, oder legt den Wert fest.

ShowReadOnly

Ruft einen Wert ab, der angibt, ob das Dialogfeld ein schreibgeschütztes Kontrollkästchen enthält, oder legt diesen fest.

Site

Ruft den ISite von Component ab oder legt ihn fest.

(Geerbt von Component)
SupportMultiDottedExtensions

Ruft ab oder legt fest, ob das Dialogfeld Anzeige und Speichern von Dateien mit mehreren Dateinamenerweiterungen unterstützt.

(Geerbt von FileDialog)
Tag

Ruft ein Objekt ab, das Daten bezüglich des Steuerelements enthält, oder legt dieses Objekt fest.

(Geerbt von CommonDialog)
Title

Ruft den Titel des Dateidialogfelds ab oder legt diesen fest.

(Geerbt von FileDialog)
ValidateNames

Ruft einen Wert ab, der angibt, ob das Dialogfeld nur gültige Win32-Dateinamen akzeptiert, oder legt diesen fest.

(Geerbt von FileDialog)

Methoden

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.

(Geerbt von Component)
Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

(Geerbt von Component)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)

Definiert die Hookprozedur für Standarddialogfelder, die überschrieben wird, um dem Dateidialogfeld spezifische Funktionen hinzuzufügen.

(Geerbt von FileDialog)
InitializeLifetimeService()
Veraltet.

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.

(Geerbt von MarshalByRefObject)
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 schreibgeschützt. Die Datei wird durch die FileName-Eigenschaft angegeben.

OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)

Definiert die Prozedur des Besitzerfensters, die überschrieben wird, um einem Standarddialogfeld spezifische Funktionen hinzuzufügen.

(Geerbt von CommonDialog)
Reset()

Setzt alle Eigenschaften auf die Standardwerte zurück.

RunDialog(IntPtr)

Gibt ein Standarddialogfeld an.

(Geerbt von FileDialog)
ShowDialog()

Führt ein Standarddialogfeld mit einem Standardbesitzer aus.

(Geerbt von CommonDialog)
ShowDialog(IWin32Window)

Führt ein Standarddialogfeld mit dem angegebenen Besitzer aus.

(Geerbt von CommonDialog)
ToString()

Stellt eine Zeichenfolgenversion dieses Objekts bereit.

(Geerbt von FileDialog)

Ereignisse

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.

(Geerbt von Component)
FileOk

Tritt ein, wenn der Benutzer in einem Dateidialogfeld auf die Schaltfläche Öffnen oder Speichern klickt.

(Geerbt von FileDialog)
HelpRequest

Tritt ein, wenn der Benutzer in einem Standarddialogfeld auf die Hilfeschaltfläche klickt.

(Geerbt von CommonDialog)

Gilt für:

Weitere Informationen