OpenFileDialog Klasse

Definition

Namespace:

Microsoft.Win32

Assembly:

PresentationFramework.dll

Stellt ein Standarddialogfeld dar, in dem Benutzer einen Dateinamen für einen oder mehrere zu öffnende Dateien angeben können.

public ref class OpenFileDialog sealed : Microsoft::Win32::FileDialog

public sealed class OpenFileDialog : Microsoft.Win32.FileDialog

type OpenFileDialog = class
    inherit FileDialog

Public NotInheritable Class OpenFileDialog
Inherits FileDialog

Vererbung

Object

CommonDialog

CommonItemDialog

FileDialog

OpenFileDialog

Beispiele

Im folgenden Beispiel wird gezeigt, wie Sie eine OpenFileDialog erstellen, die einen Standarddateinamen und Erweiterungstyp enthält.

// Configure open file dialog box
Microsoft.Win32.OpenFileDialog dlg = new Microsoft.Win32.OpenFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show open file dialog box
Nullable<bool> result = dlg.ShowDialog();

// Process open file dialog box results
if (result == true)
{
    // Open document
    string filename = dlg.FileName;
}

' Configure open file dialog box
Dim dlg As New Microsoft.Win32.OpenFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show open file dialog box
Dim result? As Boolean = dlg.ShowDialog()

' Process open file dialog box results
If result = True Then
    ' Open document
    Dim filename As String = dlg.FileName
End If

Hinweise

Sie können diese verwaltete Klasse nicht in XAML deklarieren.

Konstruktoren

OpenFileDialog()

Initialisiert eine neue Instanz der OpenFileDialog-Klasse.

Eigenschaften

AddExtension	Ruft einen Wert ab, der angibt, ob in einem Dateidialogfeld einem Dateinamen automatisch eine Dateierweiterung hinzugefügt wird, wenn diese vom Benutzer nicht angegeben wurde, oder legt ihn fest. (Geerbt von FileDialog)
AddToRecent	Ruft einen Wert ab, der angibt, ob das geöffnete oder gespeicherte Element der Liste der zuletzt verwendeten Dokumente im Dialogfeld hinzugefügt wird, oder legt diesen fest. (Geerbt von CommonItemDialog)
CheckFileExists	Ruft einen Wert ab, der angibt, ob in einem Dateidialogfeld eine Warnung angezeigt wird, wenn der Benutzer einen nicht vorhandenen Dateinamen angibt, oder legt ihn fest. (Geerbt von FileDialog)
CheckPathExists	Ruft einen Wert ab, der angibt, ob Warnungen angezeigt werden, wenn der Benutzer ungültige Pfade und Dateinamen eingibt, oder legt ihn fest. (Geerbt von FileDialog)
ClientGuid	Ruft eine GUID ab, die dem persistenten Zustand des Dialogfelds zugeordnet werden soll, oder legt diese fest. (Geerbt von CommonItemDialog)
CustomPlaces	Ruft die Liste benutzerdefinierter Speicherorte für Dateidialogfelder ab oder legt sie fest. (Geerbt von FileDialog)
DefaultDirectory	Ruft das im Dateidialogfeld angezeigte Verzeichnis ab oder legt es fest, wenn kein zuletzt verwendeter Verzeichniswert verfügbar ist. (Geerbt von CommonItemDialog)
DefaultExt	Ruft einen Wert ab, der die standardmäßige Erweiterungszeichenfolge zum Filtern der angezeigten Liste von Dateien angibt, oder legt diesen fest. (Geerbt von FileDialog)
DereferenceLinks	Ruft einen Wert ab, der angibt, ob ein Dateidialogfeld den Speicherort der Datei, auf die eine Verknüpfung verweist, oder den Speicherort der Verknüpfungsdatei (LNK) zurückgibt, oder legt diesen fest. (Geerbt von FileDialog)
FileName	Ruft eine Zeichenfolge ab, die den vollständigen Pfad der in einem Dateidialogfeld ausgewählten Datei enthält, oder legt diesen fest. (Geerbt von FileDialog)
FileNames	Ruft ein Array ab, das einen Dateinamen für jede ausgewählte Datei enthält. (Geerbt von FileDialog)
Filter	Ruft die Filterzeichenfolge ab, die angibt, welche Dateitypen aus dem OpenFileDialog bzw. aus dem SaveFileDialog angezeigt werden, oder legt diese fest. (Geerbt von FileDialog)
FilterIndex	Ruft den Index des derzeit in einem Dateidialogfeld ausgewählten Filters ab oder legt diesen fest. (Geerbt von FileDialog)
ForcePreviewPane	Ruft ein Optionsflag ab, das angibt, ob das Dialogfeld den Vorschaubereich aktiviert, oder legt es fest.
InitialDirectory	Ruft das Ausgangsverzeichnis ab, das von einem Dateidialogfeld angezeigt wird, oder legt dieses fest. (Geerbt von FileDialog)
Multiselect	Ruft eine Option ab, die angibt, ob OpenFileDialog Benutzern das Auswählen mehrerer Dateien ermöglicht, oder legt diese fest.
Options	Ruft die Win32-Dialogfeldflags für allgemeine Dateien ab, die von Dateidialogfeldern für die Initialisierung verwendet werden. (Geerbt von FileDialog)
ReadOnlyChecked	Ruft einen Wert ab, der angibt, ob das von OpenFileDialog angezeigte Kontrollkästchen für den Schreibschutz aktiviert ist, oder legt diesen fest.
RestoreDirectory	Diese Eigenschaft ist nicht implementiert. (Geerbt von FileDialog)
RootDirectory	Ruft das Verzeichnis ab, das als Navigationsstamm für das Dialogfeld angezeigt wird, oder legt es fest. (Geerbt von CommonItemDialog)
SafeFileName	Ruft eine Zeichenfolge ab, die nur den Dateinamen für die ausgewählte Datei enthält. (Geerbt von FileDialog)
SafeFileNames	Ruft ein Array ab, das einen sicheren Dateinamen für jede ausgewählte Datei enthält. (Geerbt von FileDialog)
ShowHiddenItems	Ruft einen Wert ab, der angibt, ob im Dialogfeld ausgeblendete Und Systemelemente unabhängig von den Benutzereinstellungen angezeigt werden, oder legt den Wert fest. (Geerbt von CommonItemDialog)
ShowReadOnly	Ruft einen Wert ab, der angibt, ob OpenFileDialog ein Kontrollkästchen für den Schreibschutz enthält, oder legt diesen fest.
Tag	Ruft ein Objekt ab, das dem Dialogfeld zugeordnet ist, oder legt dieses fest. Damit verfügen Sie über die Möglichkeit, an das Dialogfeld ein beliebiges Objekt anzufügen. (Geerbt von CommonDialog)
Title	Ruft den Text ab, der in der Titelleiste eines Dateidialogfelds angezeigt wird, 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 den Wert fest. (Geerbt von FileDialog)

Methoden

CheckPermissionsToShowDialog()	Bestimmt, ob ausreichende Berechtigungen zum Anzeigen eines Dialogfelds vorhanden sind. (Geerbt von CommonDialog)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definiert die Hookprozedur für Datei-Standarddialogfelder, die überschrieben wird, um einem Dateidialogfeld Standardfunktionen hinzuzufügen. (Geerbt von FileDialog)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnFileOk(CancelEventArgs)	Löst das FileOk-Ereignis aus. (Geerbt von FileDialog)
OnItemOk(CancelEventArgs)	Löst das FileOk-Ereignis aus. (Geerbt von FileDialog)
OpenFile()	Öffnet einen schreibgeschützten Stream für die Datei, die vom Benutzer mit OpenFileDialog ausgewählt wurde.
OpenFiles()	Erstellt ein Array, das für jede Datei, die vom Benutzer mit OpenFileDialog ausgewählt wird, einen schreibgeschützten Stream enthält.
Reset()	Setzt alle OpenFileDialog-Eigenschaften auf ihre Standardwerte zurück.
RunDialog(IntPtr)	RunDialog(IntPtr) wird aufgerufen, um ein Dateidialogfeld in einer abgeleiteten Klasse anzuzeigen, z. B. OpenFileDialog und SaveFileDialog. (Geerbt von FileDialog)
ShowDialog()	Zeigt ein Standarddialogfeld an. (Geerbt von CommonDialog)
ShowDialog(Window)	Zeigt ein Standarddialogfeld an. (Geerbt von CommonDialog)
ToString()	Gibt eine Zeichenfolge zurück, die ein Dateidialogfeld darstellt. (Geerbt von FileDialog)

Ereignisse

FileOk

Tritt auf, wenn ein Benutzer einen Dateinamen durch Klicken auf die Schaltfläche Öffnen im OpenFileDialog bzw. die Schaltfläche Speichern im SaveFileDialog auswählt. (Geerbt von FileDialog)

Weitere Informationen

• SaveFileDialog