FilePickerSelectedFilesArray 类

定义

命名空间:

Windows.Storage.Pickers

表示用户使用文件选取器选择的存储文件的集合。

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)

继承

Object Platform::Object IInspectable FilePickerSelectedFilesArray

属性

ContractVersionAttribute MarshalingBehaviorAttribute

实现

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

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

文件选取器示例演示如何在调用 fileOpenPicker.pickMultipleFilesAsync 后捕获已选取文件的示例) 中捕获 filePickerSelectedFilesArrayfiles (。

注意

你应始终确保你的应用未 (贴靠，或者可以取消贴靠) 并设置文件选取器属性，无论用户是选取单个文件还是多个文件。

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

注解

当对 fileOpenPicker.pickMultipleFilesAsync 方法的调用成功完成时，它将返回一个 filePickerSelectedFilesArray 对象，该对象包含用户选取的所有文件。 此数组中选取的文件由 storageFile 对象表示。

集合成员列表

对于 JavaScript，FilePickerSelectedFilesArray 具有成员列表中显示的成员。 此外，FilePickerSelectedFilesArray 支持 length 属性、 Array.prototype 的成员以及使用索引来访问项。

枚举 C# 或 Microsoft Visual Basic 中的集合

FilePickerSelectedFilesArray 是可枚举的，因此可以使用特定于语言的语法（如 C# 中的 foreach ）枚举集合中的项。 编译器为你执行类型强制转换，你无需显式转换为 IEnumerable<StorageFile> 。 如果需要显式强制转换（例如，如果要调用 GetEnumerator），请使用 StorageFile 约束强制转换为 IEnumerable<T>。

属性

Size	获取集合中 StorageFile 对象的数目。

方法

First()	检索循环访问代表所选文件的 StorageFile 对象的集合的迭代器。
GetAt(UInt32)	返回集合中指定索引处的 StorageFile 对象。
GetMany(UInt32, StorageFile[])	检索从集合中的指定索引处开始的 StorageFile 对象。
IndexOf(StorageFile, UInt32)	检索集合中指定 StorageFile 对象的索引。

另请参阅

• PickMultipleFilesAsync()
• 文件选取器示例