FilePickerSelectedFilesArray Klasse

Definition

Namespace:

Windows.Storage.Pickers

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)]
/// [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)]
[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

Object Platform::Object IInspectable FilePickerSelectedFilesArray

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Implementiert

IIterable<T> IEnumerable<T> IIterable<StorageFile> IEnumerable<StorageFile> IVectorView<StorageFile> IReadOnlyList<StorageFile>

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.

Weitere Informationen

• PickMultipleFilesAsync()
• Beispiel zur Dateiauswahl