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


var fileSavePicker = new Windows.Storage.Pickers.FileSavePicker();

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.


// Verify that we are currently not snapped, or that we can unsnap to open the picker
var currentState = Windows.UI.ViewManagement.ApplicationView.value;
if (currentState === Windows.UI.ViewManagement.ApplicationViewState.snapped &&
    !Windows.UI.ViewManagement.ApplicationView.tryUnsnap()) {
    // Fail silently if we can't unsnap
    return;
}

// Create the picker object and set options
var savePicker = new Windows.Storage.Pickers.FileSavePicker();
savePicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.documentsLibrary;
// Dropdown of file types the user can save the file as
savePicker.fileTypeChoices.insert("Plain Text", [".txt"]);
// Default file name if the user does not type one in or select a file to replace
savePicker.suggestedFileName = "New Document";

savePicker.pickSaveFileAsync().then(function (file) {
    if (file) {
        // Prevent updates to the remote version of the file until we finish making changes and call CompleteUpdatesAsync.
        Windows.Storage.CachedFileManager.deferUpdates(file);
        // write to file
        Windows.Storage.FileIO.writeTextAsync(file, file.name).done(function () {
            // Let Windows know that we're finished changing the file so the other app can update the remote version of the file.
            // Completing updates may require Windows to ask for user input.
            Windows.Storage.CachedFileManager.completeUpdatesAsync(file).done(function (updateStatus) {
                if (updateStatus === Windows.Storage.Provider.FileUpdateStatus.complete) {
                    WinJS.log && WinJS.log("File " + file.name + " was saved.", "sample", "status");
                } else {
                    WinJS.log && WinJS.log("File " + file.name + " couldn't be saved.", "sample", "status");
                }
            });
        });
    } else {
        WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
    }
});


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