SaveFileDialog Klasse

Definition

Namespace:

Microsoft.Win32

Assembly:

PresentationFramework.dll

Stellt ein Standarddialogfeld dar, in dem Benutzer einen Dateinamen angeben können, unter dem eine Datei gespeichert werden soll. SaveFileDialog kann nicht von einer Anwendung verwendet werden, die mit teilweiser Vertrauenswürdigkeit 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

CommonItemDialog

FileDialog

SaveFileDialog

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Ein SaveFileDialog erstellt und das Ergebnis verarbeitet wird.

// 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 == true)
{
    // 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

SaveFileDialog()

Initialisiert eine neue Instanz der SaveFileDialog-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 Dialogfeld das geöffnete oder gespeicherte Element der Liste der zuletzt verwendeten Dokumente hinzugibt, 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)
CreatePrompt	Ruft einen Wert ab, der angibt, ob SaveFileDialog den Benutzer nach der Berechtigung zum Erstellen einer Datei abfragt, wenn dieser eine nicht vorhandene Datei angibt, oder legt diesen fest.
CreateTestFile	Ruft einen Wert ab, der angibt, ob das Dialogfeld versucht, eine Testdatei im ausgewählten Pfad zu erstellen, oder legt diesen fest.
CustomPlaces	Ruft die Liste benutzerdefinierter Speicherorte für Dateidialogfelder ab oder legt sie fest. (Geerbt von FileDialog)
DefaultDirectory	Ruft das verzeichnis ab, das im Dateidialogfeld angezeigt wird, 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)
InitialDirectory	Ruft das Ausgangsverzeichnis ab, das von einem Dateidialogfeld angezeigt wird, oder legt dieses fest. (Geerbt von FileDialog)
Options	Ruft die Win32-Dialogfeldflags für allgemeine Dateien ab, die von Dateidialogfeldern für die Initialisierung verwendet werden. (Geerbt von FileDialog)
OverwritePrompt	Ruft einen Wert ab, der angibt, ob SaveFileDialog eine Warnung anzeigt, wenn der Benutzer den Namen einer bereits vorhandenen Datei angibt, 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)
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()	Erstellt einen Lese-Schreib-Dateistream für den Dateinamen, der vom Benutzer mit SaveFileDialog ausgewählt wurde.
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. 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

• OpenFileDialog