FilePickerSelectedFilesArray Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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)]
class FilePickerSelectedFilesArray final : 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)]
public sealed class FilePickerSelectedFilesArray : IEnumerable<StorageFile>, IReadOnlyList<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à
- Attributi
- Implementazioni
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. |