FileSavePicker Class

Stellt eine Dateiauswahl dar, mit der Benutzer den Dateinamen, die Erweiterung und den Speicherort für eine Datei auswählen können.

Syntax


public ref class FileSavePicker sealed 

Attribute

[Muse()]
[Version(0x06020000)]

Member

FileSavePickerKlasse hat diese Membertypen:

Konstruktoren

FileSavePickerKlasse hat diese Konstruktoren.

KonstruktorBeschreibung
FileSavePicker Creates a new instance of a FileSavePicker.

 

Methoden

The FileSavePicker Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus Object Klasse.

MethodeBeschreibung
PickSaveFileAsync Shows the file picker so that the user can save a file and set the file name, extension, and location of the file to be saved.

 

Eigenschaften

Der FileSavePickerKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

CommitButtonText

Lese-/SchreibzugriffGets or sets the label text of the commit button in the file pickerUI.

DefaultFileExtension

Lese-/SchreibzugriffGets or sets the default file name extension that the fileSavePicker gives to files to be saved.

FileTypeChoices

SchreibgeschütztGets the collection of valid file types that the user can choose to assign to a file.

SettingsIdentifier

Lese-/SchreibzugriffGets or sets the settings identifier associated with the current FileSavePicker instance.

SuggestedFileName

Lese-/SchreibzugriffGets or sets the file name that the file save picker suggests to the user.

SuggestedSaveFile

Lese-/SchreibzugriffGets or sets the storageFile that the file picker suggests to the user for saving a file.

SuggestedStartLocation

Lese-/SchreibzugriffGets or sets the location that the file save picker suggests to the user as the location to save a file.

 

Hinweise

Informationen zum Speichern von Dateien mithilfe der Dateiauswahl finden Sie unter So wird's gemacht: Speichern von Dateien durch Dateiauswahlen.

Einen Einstieg in das Zugreifen auf Dateien und Ordner über die Dateiauswahl finden Sie unter Schnellstart: Zugreifen auf Dateien über die Dateiauswahl.

Warnung  Wenn Sie die Dateiauswahl anzeigen, während die App ausgerichtet wird, wird die Dateiauswahl möglicherweise nicht angezeigt, und es wird eine Ausnahme ausgelöst. Sie können dies vermeiden, indem Sie sicherstellen, dass Ihre App nicht angedockt wird oder indem Sie das Andocken rückgängig machen, ehe Sie die Dateiauswahl aufrufen. Die folgenden Codebeispiele und das Dateiauswahlbeispiel veranschaulichen Ihnen, wie es gemacht wird.

Beispiele

Das Dateiauswahlbeispiel zeigt, wie sichergestellt wird, dass die App angedockt ist, wie die Dateiauswahleigenschaften festgelegt und eine Dateiauswahl so anzeigt wird, dass der Benutzer eine Datei speichern kann.

Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.

Bei C# zeigt das Beispiel für die Dateiauswahl, wie überprüft wird, ob die App an die EnsureUnsnapped-Methode angedockt ist.


internal bool EnsureUnsnapped()
{
    // FilePicker APIs will not work if the application is in a snapped state.
    // If an app wants to show a FilePicker while snapped, it must attempt to unsnap first
    bool unsnapped = ((ApplicationView.Value != ApplicationViewState.Snapped) || ApplicationView.TryUnsnap());
    if (!unsnapped)
    {
        NotifyUser("Cannot unsnap the sample.", NotifyType.StatusMessage);
    }

    return unsnapped;
}


Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Namespace

Windows.Storage.Pickers
Windows::Storage::Pickers [C++]

Metadaten

Windows.winmd

Siehe auch

Dateiauswahlbeispiel
Schnellstart: Zugreifen auf Dateien über die Dateiauswahl
Speichern von Dateien durch Dateiauswahlen
Windows.Storage.StorageFile class

 

 

Anzeigen:
© 2014 Microsoft