FilePickerSelectedFilesArray Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Sammlung von Speicherdateien dar, die der Benutzer mithilfe einer Dateiauswahl ausgewählt hat.
public ref class FilePickerSelectedFilesArray sealed : IIterable<StorageFile ^>, IVectorView<StorageFile ^>/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class FilePickerSelectedFilesArray final : IIterable<StorageFile>, IVectorView<StorageFile>/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class FilePickerSelectedFilesArray final : IIterable<StorageFile>, IVectorView<StorageFile>[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class FilePickerSelectedFilesArray : IEnumerable<StorageFile>, IReadOnlyList<StorageFile>[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class FilePickerSelectedFilesArray : IEnumerable<StorageFile>, IReadOnlyList<StorageFile>Public NotInheritable Class FilePickerSelectedFilesArray
Implements IEnumerable(Of StorageFile), IReadOnlyList(Of StorageFile)- Vererbung
- Attribute
- Implementiert
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Beispiele
Das Beispiel für die Dateiauswahl veranschaulicht, wie die dateiPickerSelectedFilesArray (files im Beispiel) ausgewählter Dateien nach dem Aufruf von fileOpenPicker.pickMultipleFilesAsync erfasst wird.
Hinweis
Sie sollten immer sicherstellen, dass Ihre App nicht angedockt ist (oder dass sie nicht verwendet werden kann) und Dateiauswahleigenschaften festlegen, unabhängig davon, ob der Benutzer eine einzelne Datei oder mehrere Dateien auswählt.
IReadOnlyList<StorageFile> files = await openPicker.PickMultipleFilesAsync();
if (files.Count > 0)
{
StringBuilder output = new StringBuilder("Picked files:\n");
// Application now has read/write access to the picked file(s)
foreach (StorageFile file in files)
{
output.Append(file.Name + "\n");
}
OutputTextBlock.Text = output.ToString();
}
else
{
OutputTextBlock.Text = "Operation cancelled.";
}
Hinweise
Wenn ein Aufruf der Methode fileOpenPicker.pickMultipleFilesAsync erfolgreich abgeschlossen wurde, wird ein filePickerSelectedFilesArray-Objekt zurückgegeben, das alle dateien enthält, die vom Benutzer ausgewählt wurden. Ausgewählte Dateien in diesem Array werden durch storageFile-Objekte dargestellt.
Auflistungsmemberlisten
Für JavaScript enthält FilePickerSelectedFilesArray die Member in den Memberlisten. Darüber hinaus unterstützt FilePickerSelectedFilesArray eine length-Eigenschaft , Member von Array.prototype und die Verwendung eines Indexes für den Zugriff auf Elemente.
Auflisten der Sammlung in C# oder Microsoft Visual Basic
FilePickerSelectedFilesArray ist aufzählbar, sodass Sie sprachspezifische Syntax wie foreach in C# verwenden können, um die Elemente in der Auflistung aufzulisten. Der Compiler führt die Typumwandlung für Sie durch, und Sie müssen nicht explizit in IEnumerable<StorageFile> umgewandelt werden. Wenn Sie eine explizite Umwandlung durchführen müssen, z. B. wenn Sie GetEnumerator aufrufen möchten, wandeln Sie mit einer StorageFile-Einschränkung in IEnumerable<T> um.
Eigenschaften
| Size |
Ruft die Anzahl der StorageFile-Objekte in der Auflistung ab. |
Methoden
| First() |
Ruft einen Iterator ab, der die Auflistung der StorageFile-Objekte durchläuft, die ausgewählte Dateien darstellen. |
| GetAt(UInt32) |
Gibt das StorageFile-Objekt am angegebenen Index in der Auflistung zurück. |
| GetMany(UInt32, StorageFile[]) |
Ruft die StorageFile-Objekte ab, die am angegebenen Index in der Auflistung beginnen. |
| IndexOf(StorageFile, UInt32) |
Ruft den Index eines angegebenen StorageFile-Objekts in der Auflistung ab. |