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)

Примеры

В примере средства выбора файлов показано, как записать файлPickerSelectedFilesArray (files в примере) выбранных файлов после вызова метода fileOpenPicker.pickMultipleFilesAsync.

Примечание

Всегда следует убедиться, что приложение не прикреплено (или оно может быть не подключено) и задавать свойства средства выбора файлов независимо от того, выбирает ли пользователь один файл или несколько файлов.

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 перечисляется, поэтому для перечисления элементов в коллекции можно использовать синтаксис для конкретного языка, например foreach в C#. Компилятор выполняет приведение типов, и вам не нужно явно приводить к IEnumerable<StorageFile> . Если вам нужно выполнить приведение явным образом, например, если вы хотите вызвать GetEnumerator, приведите к IEnumerable<T> с ограничением StorageFile .

Свойства

Size	Возвращает количество объектов StorageFile в коллекции.

Методы

First()	Извлекает итератор, который выполняет итерацию по коллекции объектов StorageFile , представляющих выбранные файлы.
GetAt(UInt32)	Возвращает объект StorageFile по указанному индексу в коллекции.
GetMany(UInt32, StorageFile[])	Извлекает объекты StorageFile , которые начинаются с указанного индекса в коллекции.
IndexOf(StorageFile, UInt32)	Извлекает индекс указанного объекта StorageFile в коллекции.

См. также раздел

• PickMultipleFilesAsync()
• Пример средства выбора файлов