FilePickerSelectedFilesArray Classe

Definição

Namespace:

Windows.Storage.Pickers

Representa uma coleção de arquivos de armazenamento que o usuário selecionou usando um seletor de arquivos.

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)

Herança

Object Platform::Object IInspectable FilePickerSelectedFilesArray

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

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

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo do seletor de arquivos demonstra como capturar o filePickerSelectedFilesArray (files no exemplo) de arquivos escolhidos depois de chamar fileOpenPicker.pickMultipleFilesAsync.

Observação

Você sempre deve ter certeza de que seu aplicativo não está ajustado (ou se ele pode ser desmarcado) e definir propriedades do seletor de arquivos, independentemente de o usuário estar escolhendo um único arquivo ou vários arquivos.

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

Comentários

Quando uma chamada para o método fileOpenPicker.pickMultipleFilesAsync for concluída com êxito, ela retornará um objeto filePickerSelectedFilesArray que contém todos os arquivos que foram escolhidos pelo usuário. Os arquivos escolhidos nesta matriz são representados por objetos storageFile .

Listas de membros da coleção

Para JavaScript, FilePickerSelectedFilesArray tem os membros mostrados nas listas de membros. Além disso, FilePickerSelectedFilesArray dá suporte a uma propriedade length , membros de Array.prototype e usando um índice para acessar itens.

Enumerando a coleção em C# ou Microsoft Visual Basic

FilePickerSelectedFilesArray é enumerável, portanto, você pode usar a sintaxe específica da linguagem, como foreach em C# para enumerar os itens na coleção. O compilador faz a conversão de tipo para você e você não precisará converter IEnumerable<StorageFile> explicitamente. Se você precisar converter explicitamente, por exemplo, se quiser chamar GetEnumerator, converta para IEnumerable<T> com uma restrição StorageFile .

Propriedades

Size	Obtém o número de objetos StorageFile na coleção.

Métodos

First()	Recupera um iterador que itera por meio da coleção de objetos StorageFile que representam arquivos selecionados.
GetAt(UInt32)	Retorna o objeto StorageFile no índice especificado na coleção.
GetMany(UInt32, StorageFile[])	Recupera os objetos StorageFile que começam no índice especificado na coleção.
IndexOf(StorageFile, UInt32)	Recupera o índice de um objeto StorageFile especificado na coleção.

Confira também

• PickMultipleFilesAsync()
• Exemplo do seletor de arquivos