SaveFileDialog Klasse

Definition

Namespace:
Microsoft.Win32
Assembly:
PresentationFramework.dll

Stellt ein allgemeines Dialogfeld dar, in dem der Benutzer einen Dateinamen zum Speichern einer Datei angeben kann. SaveFileDialog kann nicht von einer Anwendung verwendet werden, die unter teilweise vertrauenswürdiger Ausführung ausgeführt wird.

public ref class SaveFileDialog sealed : Microsoft::Win32::FileDialog
public sealed class SaveFileDialog : Microsoft.Win32.FileDialog
type SaveFileDialog = class
    inherit FileDialog
Public NotInheritable Class SaveFileDialog
Inherits FileDialog
Vererbung
Object
CommonDialog
FileDialog
SaveFileDialog
Vererbung
Object
CommonDialog
CommonItemDialog
FileDialog
SaveFileDialog

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie ein SaveFileDialog Ergebnis erstellen und verarbeiten.

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

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

// Process save file dialog box results
if (result.Value)
{
    // Save document
    string filename = dlg.FileName;
}

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

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

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

Hinweise

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

Konstruktoren

Name Beschreibung
SaveFileDialog()

Initialisiert eine neue Instanz der SaveFileDialog-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)
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.

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

Dient zum Abrufen oder Festlegen einer GUID, die dem permanenten Zustand des Dialogfelds zugeordnet werden soll.

(Geerbt von CommonItemDialog)
CreatePrompt

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob SaveFileDialog der Benutzer aufgefordert wird, eine Datei zu erstellen, wenn der Benutzer eine Datei angibt, die nicht vorhanden ist.
CreateTestFile

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Dialogfeld versucht, eine Testdatei im ausgewählten Pfad zu erstellen.
CustomPlaces

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

(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

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

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

(Geerbt von FileDialog)
OverwritePrompt

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob SaveFileDialog eine Warnung angezeigt wird, wenn der Benutzer den Namen einer datei angibt, die bereits vorhanden ist.
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

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.

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

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

Löst das FileOk-Ereignis aus.

(Geerbt von FileDialog)
OpenFile()

Erstellt einen Lese-/Schreib-Dateidatenstrom für den vom Benutzer ausgewählten Dateinamen.SaveFileDialog
Reset()

Setzt alle SaveFileDialog 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