FilePickerSelectedFilesArray Classe

Définition

Espace de noms:

Windows.Storage.Pickers

Représente une collection de fichiers de stockage que l’utilisateur a sélectionnés à l’aide d’un sélecteur de fichiers.

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)

Héritage

Object Platform::Object IInspectable FilePickerSelectedFilesArray

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

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

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple de sélecteur de fichiers montre comment capturer le fichierPickerSelectedFilesArray (files dans l’exemple) des fichiers sélectionnés après l’appel de fileOpenPicker.pickMultipleFilesAsync.

Notes

Vous devez toujours vous assurer que votre application n’est pas ancrée (ou qu’elle peut être non activée) et définir les propriétés du sélecteur de fichiers, que l’utilisateur sélectionne un seul fichier ou plusieurs fichiers.

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

Remarques

Lorsqu’un appel à la méthode fileOpenPicker.pickMultipleFilesAsync se termine correctement, il retourne un objet filePickerSelectedFilesArray qui contient tous les fichiers sélectionnés par l’utilisateur. Les fichiers sélectionnés dans ce tableau sont représentés par des objets storageFile .

Listes de membres de la collection

Pour JavaScript, FilePickerSelectedFilesArray contient les membres affichés dans les listes de membres. En outre, FilePickerSelectedFilesArray prend en charge une propriété length , les membres de Array.prototype et l’utilisation d’un index pour accéder aux éléments.

Énumération de la collection en C# ou Microsoft Visual Basic

FilePickerSelectedFilesArray étant énumérable, vous pouvez utiliser la syntaxe propre au langage, telle que foreach en C# pour énumérer les éléments de la collection. Le compilateur effectue le cast de type pour vous et vous n’aurez pas besoin d’effectuer un cast IEnumerable<StorageFile> vers explicitement. Si vous avez besoin d’un cast explicite, par exemple si vous souhaitez appeler GetEnumerator, effectuez un cast en IEnumerable<T> avec une contrainte StorageFile .

Propriétés

Size	Obtient le nombre d’objets StorageFile dans la collection.

Méthodes

First()	Récupère un itérateur qui itère dans la collection d’objets StorageFile qui représentent les fichiers sélectionnés.
GetAt(UInt32)	Retourne l’objet StorageFile à l’index spécifié dans la collection.
GetMany(UInt32, StorageFile[])	Récupère les objets StorageFile qui commencent à l’index spécifié dans la collection.
IndexOf(StorageFile, UInt32)	Récupère l’index d’un objet StorageFile spécifié dans la collection.

Voir aussi

• PickMultipleFilesAsync()
• Exemple de sélecteur de fichiers