OpenFileDialog Klasse

Definition

Namespace:
Microsoft.Win32
Assembly:
PresentationFramework.dll

Stellt ein allgemeines Dialogfeld dar, in dem ein Benutzer einen Dateinamen für eine oder mehrere zu öffnende Dateien angeben kann.

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

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Datei 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.Value)
{
    // 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

Name Beschreibung
OpenFileDialog()

Initialisiert eine neue Instanz der OpenFileDialog-Klasse.

Eigenschaften

Name Beschreibung
AddExtension

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Dateidialogfeld automatisch eine Erweiterung zu einem Dateinamen hinzufügt, wenn der Benutzer eine Erweiterung ausgelassen.

(Geerbt von FileDialog)
CheckFileExists

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Dateidialogfeld eine Warnung anzeigt, wenn der Benutzer einen Dateinamen angibt, der nicht vorhanden ist.

(Geerbt von FileDialog)
CheckPathExists

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Warnungen angezeigt werden, wenn der Benutzer ungültige Pfade und Dateinamen eingibt.

(Geerbt von FileDialog)
CustomPlaces

Dient zum Abrufen oder Festlegen der Liste der benutzerdefinierten Orte für Dateidialogfelder.

(Geerbt von FileDialog)
DefaultExt

Dient zum Abrufen oder Festlegen eines Werts, der die standarderweiterungszeichenfolge angibt, die zum Filtern der Liste der angezeigten Dateien verwendet werden soll.

(Geerbt von FileDialog)
DereferenceLinks

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Dateidialogfeld entweder den Speicherort der Datei zurückgibt, auf die durch eine Verknüpfung verwiesen wird, oder den Speicherort der Verknüpfungsdatei (.lnk).

(Geerbt von FileDialog)
FileName

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den vollständigen Pfad der datei enthält, die in einem Dateidialogfeld ausgewählt ist.

(Geerbt von FileDialog)
FileNames

Ruft ein Array ab, das einen Dateinamen für jede ausgewählte Datei enthält.

(Geerbt von FileDialog)
Filter

Dient zum Abrufen oder Festlegen der Filterzeichenfolge, die bestimmt, welche Dateitypen entweder aus dem oder OpenFileDialogdem SaveFileDialog .

(Geerbt von FileDialog)
FilterIndex

Dient zum Abrufen oder Festlegen des Index des Filters, der derzeit in einem Dateidialogfeld ausgewählt ist.

(Geerbt von FileDialog)
InitialDirectory

Ruft das anfängliche Verzeichnis ab, das in einem Dateidialogfeld angezeigt wird, oder legt dieses fest.

(Geerbt von FileDialog)
Multiselect

Dient zum Abrufen oder Festlegen einer Option, die angibt, ob OpenFileDialog Benutzer mehrere Dateien auswählen können.
Options

Ruft die allgemeinen Win32-Dateidialog-Flags ab, die von Dateidialogfeldern für die Initialisierung verwendet werden.

(Geerbt von FileDialog)
ReadOnlyChecked

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das schreibgeschützte Kontrollkästchen aktiviert OpenFileDialog ist.
RestoreDirectory

Diese Eigenschaft ist nicht implementiert.

(Geerbt von FileDialog)
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)
ShowReadOnly

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob OpenFileDialog ein schreibgeschütztes Kontrollkästchen enthält.
Tag

Dient zum Abrufen oder Festlegen eines Objekts, das dem Dialogfeld zugeordnet ist. Dies ermöglicht das Anfügen eines beliebigen Objekts an das Dialogfeld.

(Geerbt von CommonDialog)
Title

Dient zum Abrufen oder Festlegen des Texts, der in der Titelleiste eines Dateidialogfelds angezeigt wird.

(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
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()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

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

Definiert die allgemeine Dateidialog-Hook-Prozedur, die außer Kraft gesetzt wird, um einem Dateidialogfeld allgemeine Funktionen hinzuzufügen.

(Geerbt von FileDialog)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
OnFileOk(CancelEventArgs)

Löst das FileOk-Ereignis aus.

(Geerbt von FileDialog)
OpenFile()

Öffnet einen schreibgeschützten Datenstrom für die Datei, die vom Benutzer ausgewählt wird.OpenFileDialog
OpenFiles()

Erstellt ein Array, das einen schreibgeschützten Datenstrom für jede vom Benutzer OpenFileDialogausgewählte Datei 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 OpenFileDialog . B. und SaveFileDialog.

(Geerbt von FileDialog)
ShowDialog()

Zeigt ein allgemeines Dialogfeld an.

(Geerbt von CommonDialog)
ShowDialog(Window)

Zeigt ein allgemeines Dialogfeld an.

(Geerbt von CommonDialog)
ToString()

Gibt eine Zeichenfolge zurück, die ein Dateidialogfeld darstellt.

(Geerbt von FileDialog)

Ereignisse

Name Beschreibung
FileOk

Tritt auf, wenn der Benutzer einen Dateinamen auswählt, indem er entweder auf die Schaltfläche " Öffnen " der Schaltfläche oder OpenFileDialog auf die Schaltfläche "Speichern" der Schaltfläche " Speichern " klickt SaveFileDialog.

(Geerbt von FileDialog)

Gilt für:

Weitere Informationen