Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

FileOpenPicker Class

Stellt ein Benutzeroberflächenelement dar, mit dem Benutzer Dateien öffnen und die auswählen können.

Syntax


var fileOpenPicker = new Windows.Storage.Pickers.FileOpenPicker();

Attribute

ActivatableAttribute(NTDDI_WIN8)
MuseAttribute()
VersionAttribute(NTDDI_WIN8)

Member

Der FileOpenPickerKlasse hat die folgenden Arten von Mitgliedern:

Konstruktoren

Der FileOpenPickerKlasse hat die folgenden Konstruktoren.

KonstruktorBeschreibung
FileOpenPicker Creates a new instance of a FileOpenPicker.

 

Methoden

The FileOpenPicker Klasse verfügt über die folgenden Methoden. Mit C#, Visual Basic und C++ erbt er außerdem Methoden von Object Klasse.

MethodeBeschreibung
PickMultipleFilesAsync Shows the file picker so that the user can pick multiple files.
PickSingleFileAsync Shows the file picker so that the user can pick one file.

 

Eigenschaften

FileOpenPickerKlasse hat die folgenden Eigenschaften.

EigenschaftZugriffstypBeschreibung

CommitButtonText

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

FileTypeFilter

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

SettingsIdentifier

Lese-/SchreibzugriffGets or sets the settings identifier associated with the state of the file open picker.

SuggestedStartLocation

Lese-/SchreibzugriffGets or sets the initial location where the file open picker looks for files to present to the user.

ViewMode

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

 

Anmerkungen

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 auswählen 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 openPicker = new Windows.Storage.Pickers.FileOpenPicker();
openPicker.viewMode = Windows.Storage.Pickers.PickerViewMode.thumbnail;
openPicker.suggestedStartLocation = Windows.Storage.Pickers.PickerLocationId.picturesLibrary;
// 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.
openPicker.fileTypeFilter.replaceAll([".png", ".jpg", ".jpeg"]);

// Open the picker for the user to pick a file
openPicker.pickSingleFileAsync().then(function (file) {
    if (file) {
        // Application now has read/write access to the picked file
        WinJS.log && WinJS.log("Picked photo: " + file.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;
}


Das Dateiauswahlbeispiel zeigt auch, wie eine Dateiauswahl angezeigt wird, sodass der Benutzer mehrere Dateien auswählen kann.

Hinweis  Sie sollten immer sicherstellen, dass die App nicht angedockt ist (bzw. das Andocken aufgehoben werden kann), und Dateiauswahleigenschaften festlegen, unabhängig davon, ob der Benutzer eine einzelne oder mehrere Dateien auswählt.


openPicker.pickMultipleFilesAsync().then(function (files) {
    if (files.size > 0) {
        // Application now has read/write access to the picked file(s)
        var outputString = "Picked files:\n";
        for (var i = 0; i < files.size; i++) {
            outputString = outputString + files[i].name + "\n";
        }
        WinJS.log && WinJS.log(outputString, "sample", "status");
    } else {
        // The picker was dismissed with no selected file
        WinJS.log && WinJS.log("Operation cancelled.", "sample", "status");
    }
});


Anforderungen

Unterstützte Mindestversion (Client)

Windows 8 [Nur Windows Store-Apps]

Unterstützte Mindestversion (Server)

Windows Server 2012 [Nur Windows Store-Apps]

Unterstützte Mindestversion (Telefon)

Windows Phone 8

Namespace

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

Metadaten

Windows.winmd

Weitere Informationen

Dateiauswahlbeispiel
Schnellstart: Zugreifen auf Dateien über die Dateiauswahl

 

 

© 2013 Microsoft. Alle Rechte vorbehalten.