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

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

Member

FileOpenPickerKlasse hat diese Membertypen:

Konstruktoren

FileOpenPickerKlasse hat diese Konstruktoren.

KonstruktorBeschreibung
FileOpenPicker Creates a new instance of a FileOpenPicker.

 

Methoden

The FileOpenPicker Klasse hat diese Methoden. Mit C#, Visual Basic und C++ erbt es auch Methoden aus 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

Der FileOpenPickerKlasse hat diese 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.

 

Hinweise

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

Wichtig  Wenn Sie versuchen, unter Windows 8 die Dateiauswahl anzeigen, während die App ausgerichtet wird, wird die Dateiauswahl 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. Beachten Sie, dass Windows 8.1 keine bestimmte ausgerichtete Fenstergröße definiert. Stattdessen können Benutzer die Größe von Apps in jede beliebige Breite bis hin zur minimalen Größe ändern. Wenn die App nur auf Windows 8.1 bereitgestellt wird, können Sie die Funktion EnsureUnsnapped ignorieren und sie im Beispielcode dieses Themas aufrufen.

Windows Phone 8

Diese API wird nur in systemeigenen Apps unterstützt.

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");
    }
});


Sie können die Dateiauswahl auch beim Windows Phone verwenden. Im Folgenden wird ein C++-Beispiel gezeigt. Unter Windows Phone wird FileOpenPicker nur in systemeigenen Apps unterstützt.


FileOpenPicker^ openPicker = ref new FileOpenPicker(); 
openPicker->ViewMode = PickerViewMode::Thumbnail; 
openPicker->SuggestedStartLocation = PickerLocationId::PicturesLibrary; 
openPicker->FileTypeFilter->Append("*"); 
   
create_task(openPicker->PickSingleFileAsync()).then([this](StorageFile^ file) 
{
    if (file) 
    { 
        m_PickedFileName = file->Name; 
    } 
    else 
    { 
        // Operation cancelled.
    } 
});


Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Mindestens unterstütztes Telefon

Windows Phone 8

Namespace

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

Metadaten

Windows.winmd

Siehe auch

Dateiauswahlbeispiel
Schnellstart: Zugreifen auf Dateien über die Dateiauswahl

 

 

Anzeigen:
© 2014 Microsoft