Freigeben über


OpenFileDialog Klasse

Definition

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
OpenFileDialog
Vererbung

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)

Gilt für:

Weitere Informationen