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.
| Konstruktor | Beschreibung |
|---|---|
| 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.
| Methode | Beschreibung |
|---|---|
| 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.
| Eigenschaft | Zugriffstyp | Beschreibung |
|---|---|---|
| Lese-/Schreibzugriff | Gets or sets the label text of the file open picker's commit button. | |
| Schreibgeschützt | Gets the collection of file types that the file open picker displays. | |
| Lese-/Schreibzugriff | Gets or sets the settings identifier associated with the state of the file open picker. | |
| Lese-/Schreibzugriff | Gets or sets the initial location where the file open picker looks for files to present to the user. | |
| Lese-/Schreibzugriff | Gets 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 |
|
|
Metadaten |
|
Weitere Informationen
