SaveFileDialog SaveFileDialog SaveFileDialog SaveFileDialog Class

Definition

Stellt ein Standarddialogfeld dar, in dem Benutzer einen Dateinamen angeben können, unter dem eine Datei gespeichert werden soll.Represents a common dialog that allows the user to specify a filename to save a file as. SaveFileDialog kann nicht von einer Anwendung verwendet werden, die mit teilweiser Vertrauenswürdigkeit ausgeführt wird.SaveFileDialog cannot be used by an application that is executing under partial trust.

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

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein SaveFileDialog erstellt und das Ergebnis verarbeitet wird.The following example demonstrates how to create a SaveFileDialog and process the result.

// 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

Die folgende Abbildung zeigt eine SaveFileDialog für Windows VistaWindows Vista.The following figure shows a SaveFileDialog for Windows VistaWindows Vista.

![Dialogfeld "Speichern] unter" (~/add/media/dialogboxesoverviewfigure3.png "Dialogfeld "Speichern") unter"Save As dialog box

Beim Öffnen und Speichern von Datei Dialogfeldern befindet **** sichaufderlinkenSeitedesDialogFeldseinBereichmitdenFavoritenLinks,mitdemBenutzerschnellzueinemanderenSpeicherortnavigierenWindows VistaWindows Vistakönnen.Starting in Windows VistaWindows Vista, open and save file dialog boxes have a Favorite Links panel on the left side of the dialog box that allows the user to quickly navigate to a different location. Diese Links werden als benutzerdefinierte Speicherorte bezeichnet.These links are called custom places. Verwenden Sie CustomPlaces die-Eigenschaft, um diese Liste von Links festzulegen.Use the CustomPlaces property to set this list of links.

Verwendung von XAML-TextXAML Text Usage

Sie können diese verwaltete Klasse nicht in XAMLXAMLdeklarieren.You cannot declare this managed class in XAMLXAML.

Konstruktoren

SaveFileDialog() SaveFileDialog() SaveFileDialog() SaveFileDialog()

Initialisiert eine neue Instanz der SaveFileDialog-Klasse.Initializes a new instance of the SaveFileDialog class.

Eigenschaften

AddExtension AddExtension AddExtension 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.Gets or sets a value indicating whether a file dialog automatically adds an extension to a file name if the user omits an extension.

(Inherited from FileDialog)
CheckFileExists CheckFileExists CheckFileExists 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.Gets or sets a value indicating whether a file dialog displays a warning if the user specifies a file name that does not exist.

(Inherited from FileDialog)
CheckPathExists CheckPathExists CheckPathExists CheckPathExists

Ruft einen Wert ab, der angibt, ob Warnungen angezeigt werden, wenn der Benutzer ungültige Pfade und Dateinamen eingibt, oder legt ihn fest.Gets or sets a value that specifies whether warnings are displayed if the user types invalid paths and file names.

(Inherited from FileDialog)
CreatePrompt CreatePrompt CreatePrompt 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.Gets or sets a value indicating whether SaveFileDialog prompts the user for permission to create a file if the user specifies a file that does not exist.

CustomPlaces CustomPlaces CustomPlaces CustomPlaces

Ruft die Liste benutzerdefinierter Speicherorte für Dateidialogfelder ab oder legt sie fest.Gets or sets the list of custom places for file dialog boxes.

(Inherited from FileDialog)
DefaultExt DefaultExt DefaultExt DefaultExt

Ruft einen Wert ab, der die standardmäßige Erweiterungszeichenfolge zum Filtern der angezeigten Liste von Dateien angibt, oder legt diesen fest.Gets or sets a value that specifies the default extension string to use to filter the list of files that are displayed.

(Inherited from FileDialog)
DereferenceLinks DereferenceLinks DereferenceLinks 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.Gets or sets a value indicating whether a file dialog returns either the location of the file referenced by a shortcut or the location of the shortcut file (.lnk).

(Inherited from FileDialog)
FileName FileName FileName FileName

Ruft eine Zeichenfolge ab, die den vollständigen Pfad der in einem Dateidialogfeld ausgewählten Datei enthält, oder legt diesen fest.Gets or sets a string containing the full path of the file selected in a file dialog.

(Inherited from FileDialog)
FileNames FileNames FileNames FileNames

Ruft ein Array ab, das einen Dateinamen für jede ausgewählte Datei enthält.Gets an array that contains one file name for each selected file.

(Inherited from FileDialog)
Filter Filter Filter Filter

Ruft die Filterzeichenfolge ab, die angibt, welche Dateitypen aus dem OpenFileDialog bzw. aus dem SaveFileDialog angezeigt werden, oder legt diese fest.Gets or sets the filter string that determines what types of files are displayed from either the OpenFileDialog or SaveFileDialog.

(Inherited from FileDialog)
FilterIndex FilterIndex FilterIndex FilterIndex

Ruft den Index des derzeit in einem Dateidialogfeld ausgewählten Filters ab oder legt diesen fest.Gets or sets the index of the filter currently selected in a file dialog.

(Inherited from FileDialog)
InitialDirectory InitialDirectory InitialDirectory InitialDirectory

Ruft das Ausgangsverzeichnis ab, das von einem Dateidialogfeld angezeigt wird, oder legt dieses fest.Gets or sets the initial directory that is displayed by a file dialog.

(Inherited from FileDialog)
Options Options Options Options

Ruft die Flags für standardmäßige Win32Win32-Dateidialogfelder ab, die von Dateidialogfeldern für die Initialisierung verwendet werden.Gets the Win32Win32 common file dialog flags that are used by file dialogs for initialization.

(Inherited from FileDialog)
OverwritePrompt OverwritePrompt OverwritePrompt 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.Gets or sets a value indicating whether SaveFileDialog displays a warning if the user specifies the name of a file that already exists.

RestoreDirectory RestoreDirectory RestoreDirectory RestoreDirectory

Diese Eigenschaft ist nicht implementiert.This property is not implemented.

(Inherited from FileDialog)
SafeFileName SafeFileName SafeFileName SafeFileName

Ruft eine Zeichenfolge ab, die nur den Dateinamen für die ausgewählte Datei enthält.Gets a string that only contains the file name for the selected file.

(Inherited from FileDialog)
SafeFileNames SafeFileNames SafeFileNames SafeFileNames

Ruft ein Array ab, das einen sicheren Dateinamen für jede ausgewählte Datei enthält.Gets an array that contains one safe file name for each selected file.

(Inherited from FileDialog)
Tag Tag Tag Tag

Ruft ein Objekt ab, das dem Dialogfeld zugeordnet ist, oder legt dieses fest.Gets or sets an object associated with the dialog. Damit verfügen Sie über die Möglichkeit, an das Dialogfeld ein beliebiges Objekt anzufügen.This provides the ability to attach an arbitrary object to the dialog.

(Inherited from CommonDialog)
Title Title Title Title

Ruft den Text ab, der in der Titelleiste eines Dateidialogfelds angezeigt wird, oder legt diesen fest.Gets or sets the text that appears in the title bar of a file dialog.

(Inherited from FileDialog)
ValidateNames ValidateNames ValidateNames ValidateNames

Ruft einen Wert ab, der angibt, ob das Dialogfeld nur gültige Win32Win32-Dateinamen akzeptiert oder legt ihn fest.Gets or sets a value indicating whether the dialog accepts only valid Win32Win32 file names.

(Inherited from FileDialog)

Methoden

CheckPermissionsToShowDialog() CheckPermissionsToShowDialog() CheckPermissionsToShowDialog() CheckPermissionsToShowDialog()

Bestimmt, ob ausreichende Berechtigungen zum Anzeigen eines Dialogfelds vorhanden sind.Determines whether sufficient permissions for displaying a dialog exist.

(Inherited from CommonDialog)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr) HookProc(IntPtr, Int32, IntPtr, IntPtr)

Definiert die Hookprozedur für Datei-Standarddialogfelder, die überschrieben wird, um einem Dateidialogfeld Standardfunktionen hinzuzufügen.Defines the common file dialog hook procedure that is overridden to add common functionality to a file dialog.

(Inherited from FileDialog)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs) OnFileOk(CancelEventArgs)

Löst das FileOk-Ereignis aus.Raises the FileOk event.

(Inherited from FileDialog)
OpenFile() OpenFile() OpenFile() OpenFile()

Erstellt einen Lese-Schreib-Dateistream für den Dateinamen, der vom Benutzer mit SaveFileDialog ausgewählt wurde.Creates a read-write file stream for the filename selected by the user using SaveFileDialog.

Reset() Reset() Reset() Reset()

Setzt alle SaveFileDialog-Eigenschaften auf ihre Standardwerte zurück.Resets all SaveFileDialog properties to their default values.

RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr) RunDialog(IntPtr)

RunDialog(IntPtr) wird aufgerufen, um ein Dateidialogfeld in einer abgeleiteten Klasse anzuzeigen, z. B. OpenFileDialog und SaveFileDialog.RunDialog(IntPtr) is called to display a file dialog in a derived class, such as OpenFileDialog and SaveFileDialog.

(Inherited from FileDialog)
ShowDialog() ShowDialog() ShowDialog() ShowDialog()

Zeigt ein Standarddialogfeld an.Displays a common dialog.

(Inherited from CommonDialog)
ShowDialog(Window) ShowDialog(Window) ShowDialog(Window) ShowDialog(Window)

Zeigt ein Standarddialogfeld an.Displays a common dialog.

(Inherited from CommonDialog)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die ein Dateidialogfeld darstellt.Returns a string that represents a file dialog.

(Inherited from FileDialog)

Ereignisse

FileOk FileOk FileOk 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.Occurs when the user selects a file name by either clicking the Open button of the OpenFileDialog or the Save button of the SaveFileDialog.

(Inherited from FileDialog)

Gilt für:

Siehe auch