信息
您所需的主题如下所示。但此主题未包含在此库中。

FilePickerSelectedFilesArray Class

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

语法


/* 有关创建或访问此对象的信息,请参见“备注”。 */

特性

[Version(0x06020000)]

成员

FilePickerSelectedFilesArray类 具有这些类型的成员:

方法

The FilePickerSelectedFilesArray 类 具有这些方法。 对于 C#、Visual Basic 和 C++,它还继承方法于Object 类.

方法说明
First [C++, JavaScript]Retrieves an iterator that iterates through the collection of StorageFile objects that represent selected files.
GetAt [C++, JavaScript]Returns the StorageFile object at the specified index in the collection.
GetMany [C++, JavaScript]Retrieves the StorageFile objects that start at the specified index in the collection.
IndexOf [C++, JavaScript]Retrieves the index of a specified StorageFile object in the collection.

 

属性

FilePickerSelectedFilesArray类 具有这些属性。

属性访问类型说明

Count [C#, VB]

只读Gets the number of elements contained in the collection.

Item [C#, VB]

只读Gets or sets the element at the specified index.

Size [C++, JavaScript]

只读Gets the number of StorageFile objects in the collection.

 

备注

成功完成对 fileOpenPicker.pickMultipleFilesAsync 方法的调用时,它会返回包含用户选择的所有文件的 filePickerSelectedFilesArray 对象。此数组中的选定文件由 storageFile 对象表示。

集合成员列表

对于 JavaScript,FilePickerSelectedFilesArray 的成员显示在成员列表中。此外,FilePickerSelectedFilesArray 支持 length 属性和 Array.prototype 的成员,还支持使用索引来访问项。

枚举在 C# 或 Microsoft Visual Basic 上的集合

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

示例

文件选择器示例演示了如何在调用 fileOpenPicker.pickMultipleFilesAsync 后获取选中文件中的filePickerSelectedFilesArray(示例中为 files)。

注意  应始终确保应用程序未对齐(或可将它展开)并且无论用户选择是单个文件或多个文件设置文件选择器属性。


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


要求

最低支持客户端

Windows 8 [仅 Windows 应用商店应用程序]

最低支持服务器

Windows Server 2012 [仅 Windows 应用商店应用程序]

命名空间

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

元数据

Windows.winmd

另请参见

文件选择器示例
快速入门:通过文件选择器访问文件
fileOpenPicker.pickMultipleFilesAsync method

 

 

显示: