FilePickerSelectedFilesArray Classe

Definizione

Spazio dei nomi:

Windows.Storage.Pickers

Rappresenta una raccolta di file di archiviazione selezionati dall'utente usando una selezione file.

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)

Ereditarietà

Object Platform::Object IInspectable FilePickerSelectedFilesArray

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

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

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

L'esempio di selezione file illustra come acquisire il filePickerSelectedFilesArray (files nell'esempio) dei file selezionati dopo aver chiamato fileOpenPicker.pickMultipleFilesAsync.

Nota

È sempre consigliabile assicurarsi che l'app non venga interrotta (o che possa essere annullata) e impostare le proprietà di selezione file indipendentemente dal fatto che l'utente stia selezionando un singolo file o più file.

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

Commenti

Quando una chiamata al metodo fileOpenPicker.pickMultipleFilesAsync viene completata correttamente, restituisce un oggetto filePickerSelectedFilesArray che contiene tutti i file selezionati dall'utente. I file selezionati in questa matrice sono rappresentati dagli oggetti storageFile .

Elenchi di membri della raccolta

Per JavaScript, FilePickerSelectedFilesArray ha i membri visualizzati negli elenchi dei membri. Inoltre, FilePickerSelectedFilesArray supporta una proprietà length , i membri di Array.prototype e l'uso di un indice per accedere agli elementi.

Enumerazione della raccolta in C# o Microsoft Visual Basic

FilePickerSelectedFilesArray è enumerabile, quindi è possibile usare una sintassi specifica del linguaggio, ad esempio foreach in C# per enumerare gli elementi dell'insieme. Il compilatore esegue il cast di tipi per l'utente e non è necessario eseguire il cast IEnumerable<StorageFile> in modo esplicito. Se è necessario eseguire il cast in modo esplicito, ad esempio se si vuole chiamare GetEnumerator, eseguire il cast in IEnumerable<T> con un vincolo StorageFile .

Proprietà

Size	Ottiene il numero di oggetti StorageFile nell'insieme.

Metodi

First()	Recupera un iteratore che esegue l'iteratore tramite l'insieme di oggetti StorageFile che rappresentano i file selezionati.
GetAt(UInt32)	Restituisce l'oggetto StorageFile nell'indice specificato nell'insieme.
GetMany(UInt32, StorageFile[])	Recupera gli oggetti StorageFile che iniziano all'indice specificato nell'insieme.
IndexOf(StorageFile, UInt32)	Recupera l'indice di un oggetto StorageFile specificato nell'insieme.

Vedi anche

• PickMultipleFilesAsync()
• Esempio di utilità di selezione file