FolderPicker-Klasse

FolderPicker Class

Stellt ein Benutzeroberflächenelement dar, in dem Benutzer Ordner auswählen können.

Syntax


var folderPicker = new Windows.Storage.Pickers.FolderPicker();

Attribute

[Version(0x06020000)]

Member

FolderPickerKlasse hat diese Membertypen:

Konstruktoren

FolderPickerKlasse hat diese Konstruktoren.

KonstruktorBeschreibung
FolderPicker Creates a new instance of a FolderPicker.

 

Methoden

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

MethodeBeschreibung
PickSingleFolderAsync Shows the folderPicker object so that the user can pick a folder.

 

Eigenschaften

Der FolderPickerKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

CommitButtonText

Lese-/SchreibzugriffGets or sets the label text of the folder picker's commit button.

FileTypeFilter

SchreibgeschütztGets the collection of file types that the folder picker displays.

SettingsIdentifier

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

SuggestedStartLocation

Lese-/SchreibzugriffGets or sets the initial location where the folder picker looks for folders to present to the user.

ViewMode

Lese-/SchreibzugriffGets or sets the view mode that the folder picker uses to display items.

 

Hinweise

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 anzeigt wird, sodass der Benutzer einen Ordner auswählen kann, auf die die App zugreift.


// 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 folderPicker = new Windows.Storage.Pickers.FolderPicker;
folderPicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.desktop;
// Users expect to have a filtered view of their folders depending on the scenario.
// For example, when choosing a documents folder, restrict the filetypes to documents for your application.
folderPicker.fileTypeFilter.replaceAll([".docx", ".xlsx", ".pptx"]);

folderPicker.pickSingleFolderAsync().then(function (folder) {
    if (folder) {
        // Application now has read/write access to all contents in the picked folder (including sub-folder contents)
        // Cache folder so the contents can be accessed at a later time
        Windows.Storage.AccessCache.StorageApplicationPermissions.futureAccessList.addOrReplace("PickedFolderToken", folder);
        WinJS.log && WinJS.log("Picked folder: " + folder.name, "sample", "status");
    } else {
        // The picker was dismissed with no selected file
        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

 

 

Anzeigen:
© 2016 Microsoft