FileDialog Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Eine abstrakte Basisklasse, die Funktionen kapselt, die für Dateidialogdialoge verwendet werden, einschließlich OpenFileDialog und SaveFileDialog.
public ref class FileDialog abstract : Microsoft::Win32::CommonDialog
public ref class FileDialog abstract : Microsoft::Win32::CommonItemDialog
public abstract class FileDialog : Microsoft.Win32.CommonDialog
public abstract class FileDialog : Microsoft.Win32.CommonItemDialog
type FileDialog = class
inherit CommonDialog
type FileDialog = class
inherit CommonItemDialog
Public MustInherit Class FileDialog
Inherits CommonDialog
Public MustInherit Class FileDialog
Inherits CommonItemDialog
- Vererbung
- Vererbung
- Abgeleitet
Konstruktoren
| Name | Beschreibung |
|---|---|
| FileDialog() |
Initialisiert eine neue Instanz der FileDialog-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. |
| AddToRecent |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld das Element, das geöffnet oder gespeichert wird, der Liste der zuletzt verwendeten Dokumente hinzugefügt wird. (Geerbt von CommonItemDialog) |
| 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. |
| CheckPathExists |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Warnungen angezeigt werden, wenn der Benutzer ungültige Pfade und Dateinamen eingibt. |
| ClientGuid |
Dient zum Abrufen oder Festlegen einer GUID, die dem permanenten Zustand des Dialogfelds zugeordnet werden soll. (Geerbt von CommonItemDialog) |
| CustomPlaces |
Dient zum Abrufen oder Festlegen der Liste der benutzerdefinierten Orte für Dateidialogfelder. |
| CustomPlaces |
Eine abstrakte Basisklasse, die Funktionen kapselt, die für Dateidialogdialoge verwendet werden, einschließlich OpenFileDialog und SaveFileDialog. (Geerbt von CommonItemDialog) |
| DefaultDirectory |
Ruft das im Dateidialogfeld angezeigte Verzeichnis ab oder legt es fest, wenn kein zuletzt verwendeter Verzeichniswert verfügbar ist. (Geerbt von CommonItemDialog) |
| DefaultExt |
Dient zum Abrufen oder Festlegen eines Werts, der die standarderweiterungszeichenfolge angibt, die zum Filtern der Liste der angezeigten Dateien verwendet werden soll. |
| 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). |
| 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 CommonItemDialog) |
| FileName |
Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den vollständigen Pfad der datei enthält, die in einem Dateidialogfeld ausgewählt ist. |
| FileNames |
Ruft ein Array ab, das einen Dateinamen für jede ausgewählte Datei enthält. |
| Filter |
Dient zum Abrufen oder Festlegen der Filterzeichenfolge, die bestimmt, welche Dateitypen entweder aus dem oder OpenFileDialogdem SaveFileDialog . |
| FilterIndex |
Dient zum Abrufen oder Festlegen des Index des Filters, der derzeit in einem Dateidialogfeld ausgewählt ist. |
| InitialDirectory |
Ruft das anfängliche Verzeichnis ab, das in einem Dateidialogfeld angezeigt wird, oder legt dieses fest. |
| InitialDirectory |
Ruft das anfängliche Verzeichnis ab, das im Dateidialogfeld angezeigt wird, oder legt dieses fest. (Geerbt von CommonItemDialog) |
| Options |
Ruft die allgemeinen Win32-Dateidialog-Flags ab, die von Dateidialogfeldern für die Initialisierung verwendet werden. |
| RestoreDirectory |
Diese Eigenschaft ist nicht implementiert. |
| 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. |
| SafeFileNames |
Ruft ein Array ab, das einen sicheren Dateinamen für jede ausgewählte Datei enthält. |
| ShowHiddenItems |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld ausgeblendete und Systemelemente unabhängig von den Benutzereinstellungen anzeigt. (Geerbt von CommonItemDialog) |
| 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. |
| Title |
Dient zum Abrufen oder Festlegen des Texts, der in der Titelleiste des Dateidialogfelds angezeigt wird. (Geerbt von CommonItemDialog) |
| ValidateNames |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld nur gültige Win32-Dateinamen akzeptiert. |
| ValidateNames |
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob nach Situationen gesucht werden soll, die verhindern würden, dass eine Anwendung die ausgewählte Datei öffnet, z. B. Freigabeverletzungen oder Zugriff verweigerte Fehler. (Geerbt von CommonItemDialog) |
Methoden
| Name | Beschreibung |
|---|---|
| CheckPermissionsToShowDialog() |
Bestimmt, ob ausreichende Berechtigungen zum Anzeigen eines Dialogfelds vorhanden sind. (Geerbt von CommonDialog) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (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. |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Definiert die allgemeine Dialogfeld-Hook-Prozedur, die überschrieben wird, um einem allgemeinen Dialogfeld bestimmte Funktionen hinzuzufügen. (Geerbt von CommonDialog) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnFileOk(CancelEventArgs) |
Löst das FileOk-Ereignis aus. |
| OnItemOk(CancelEventArgs) |
Löst das FileOk-Ereignis aus. |
| Reset() |
Legt alle Eigenschaften eines Dateidialogfelds auf ihre Anfangswerte zurück. |
| RunDialog(IntPtr) |
RunDialog(IntPtr) wird aufgerufen, um ein Dateidialogfeld in einer abgeleiteten Klasse anzuzeigen, z OpenFileDialog . B. und SaveFileDialog. |
| RunDialog(IntPtr) |
Führt Initialisierungsarbeiten zur Vorbereitung aus, um ein Dialogfeld zum Öffnen einer Datei, zum Speichern oder zum Öffnen eines Ordners anzuzeigen. (Geerbt von CommonItemDialog) |
| 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. |
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. |