Freigeben über


SaveFileDialog Klasse

Definition

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

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)

Gilt für:

Weitere Informationen