StorageFile Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Storage

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.

Modifica

Rappresenta un file. Fornisce informazioni sul file e sul relativo contenuto e sui modi per modificarli.

public ref class StorageFile sealed : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class StorageFile final : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class StorageFile : IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

Public NotInheritable Class StorageFile
Implements IStorageFile, IStorageFile2, IStorageFilePropertiesWithAvailability, IStorageItem2, IStorageItemProperties2, IStorageItemPropertiesWithProvider

Ereditarietà: Object Platform::Object IInspectable StorageFile

Attributi: ContractVersionAttribute

Implementazioni: IStorageFile IStorageFile2 IStorageFilePropertiesWithAvailability IStorageItem IStorageItem2 IStorageItemProperties IStorageItemProperties2 IStorageItemPropertiesWithProvider IInputStreamReference IRandomAccessStreamReference

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	documentsLibrary musicLibrary picturesLibrary videosLibrary

Esempio

Questo esempio illustra come chiamare una selezione file usando FileOpenPicker.PickSingleFileAsync per acquisire ed elaborare un file selezionato dagli utenti.

var openPicker = new FileOpenPicker();
StorageFile file = await openPicker.PickSingleFileAsync();
// Process picked file
if (file != null)
{
    // Store file for future access
    Windows.Storage.AccessCache.StorageApplicationPermissions.FutureAccessList.Add(file);
}
else
{
    // The user didn't pick a file
}

Al termine di PickSingleFileAsync , file ottiene il file selezionato come StorageFile.

Nell'esempio contiene openPicker un oggetto FileOpenPicker . Per altre informazioni sull'uso della selezione file, vedere Aprire file e cartelle con una selezione.

Ottiene inoltre fileToken un identificatore che è possibile usare per recuperare il file da FutureAccessList. Per altre informazioni sull'archiviazione di file e cartelle in modo che sia possibile accedervi di nuovo in un secondo momento, vedere FutureAccessList, MostRecentlyUsedList e Tenere traccia di file e cartelle usati di recente.

Commenti

In genere, si accede agli oggetti StorageFile come risultato di chiamate asincrone a metodi e/o funzioni. Ad esempio, entrambi i metodi statici GetFileFromPathAsync e GetFileFromApplicationUriAsync restituiscono un oggetto StorageFile che rappresenta il file specificato.

Inoltre, ogni volta che si chiama una selezione file per consentire all'utente di selezionare un file (o file) la selezione file restituirà il file come StorageFile.

Nota

Gli oggetti StorageFile non possono rappresentare file che sono tipi di file ".lnk", ".url" o ".wsh".

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
2004	19041	GetFileFromPathForUserAsync

Proprietà

Attributes	Ottiene gli attributi di un file.
ContentType	Ottiene il tipo MIME del contenuto del file.
DateCreated	Ottiene la data e l'ora di creazione del file corrente.
DisplayName	Ottiene un nome descrittivo per il file.
DisplayType	Ottiene una descrizione intuitiva del tipo di file.
FileType	Ottiene il tipo (estensione del nome file) del file.
FolderRelativeId	Ottiene un identificatore per il file. Questo ID è univoco per il risultato della query o StorageFolder che contiene il file e può essere usato per distinguere tra elementi con lo stesso nome.
IsAvailable	Indica se il file è locale, viene memorizzato nella cache in locale o può essere scaricato.
Name	Ottiene il nome del file che include l'estensione del nome file.
Path	Ottiene il percorso completo del file system del file corrente, se il file ha un percorso.
Properties	Ottiene un oggetto che fornisce l'accesso alle proprietà correlate al contenuto del file.
Provider	Ottiene l'oggetto StorageProvider che contiene informazioni sul servizio in cui è archiviato il file corrente.

Metodi

CopyAndReplaceAsync(IStorageFile)	Sostituisce il file specificato con una copia del file corrente.
CopyAsync(IStorageFolder)	Crea una copia del file nella cartella specificata.
CopyAsync(IStorageFolder, String)	Crea una copia del file nella cartella specificata e rinomina la copia.
CopyAsync(IStorageFolder, String, NameCollisionOption)	Crea una copia del file nella cartella specificata e rinomina la copia. Questo metodo specifica anche cosa fare se nella cartella di destinazione esiste già un file con lo stesso nome.
CreateStreamedFileAsync(String, StreamedFileDataRequestedHandler, IRandomAccessStreamReference)	Crea un oggetto StorageFile per rappresentare il flusso di dati specificato. Questo metodo consente all'app di produrre i dati su richiesta specificando una funzione da richiamare quando si accede per la prima volta a StorageFile che rappresenta il flusso.
CreateStreamedFileFromUriAsync(String, Uri, IRandomAccessStreamReference)	Crea un oggetto StorageFile per rappresentare un flusso di dati dalla risorsa URI (Uniform Resource Identifier) specificata. Questo metodo consente all'app di scaricare i dati su richiesta quando si accede a StorageFile che rappresenta il flusso.
DeleteAsync()	Elimina il file corrente.
DeleteAsync(StorageDeleteOption)	Elimina il file corrente, eliminando facoltativamente l'elemento in modo permanente.
GetBasicPropertiesAsync()	Ottiene le proprietà di base del file corrente.
GetFileFromApplicationUriAsync(Uri)	Ottiene un oggetto StorageFile per rappresentare la risorsa app URI (Uniform Resource Identifier) specificata. Per esempi di URI di esempio, vedere Caricare immagini e asset personalizzati per la scalabilità, il tema, il contrasto elevato e altri.
GetFileFromPathAsync(String)	Ottiene un oggetto StorageFile per rappresentare il file nel percorso specificato.
GetFileFromPathForUserAsync(User, String)	Ottiene un oggetto StorageFile basato su un percorso assoluto nel file system per un determinato utente.
GetParentAsync()	Ottiene la cartella padre del file corrente.
GetScaledImageAsThumbnailAsync(ThumbnailMode)	Ottiene un'immagine ridimensionata come anteprima, determinata dallo scopo dell'anteprima.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32)	Ottiene un'immagine ridimensionata come anteprima, determinata dallo scopo dell'anteprima e dalle dimensioni richieste.
GetScaledImageAsThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Ottiene un'immagine ridimensionata come anteprima, determinata dallo scopo dell'anteprima, dalle dimensioni richieste e dalle opzioni specificate
GetThumbnailAsync(ThumbnailMode)	Recupera un'immagine di anteprima modificata per il file, determinata dallo scopo dell'anteprima.
GetThumbnailAsync(ThumbnailMode, UInt32)	Recupera un'immagine di anteprima modificata per il file, determinata dallo scopo dell'anteprima e dalle dimensioni richieste.
GetThumbnailAsync(ThumbnailMode, UInt32, ThumbnailOptions)	Recupera un'immagine di anteprima modificata per il file, determinata dallo scopo dell'anteprima, dalle dimensioni richieste e dalle opzioni specificate.
IsEqual(IStorageItem)	Indica se il file corrente è uguale al file specificato.
IsOfType(StorageItemTypes)	Determina se l'oggetto StorageFile corrente corrisponde al valore StorageItemTypes specificato.
MoveAndReplaceAsync(IStorageFile)	Sposta il file corrente nel percorso del file specificato e sostituisce il file specificato in tale percorso.
MoveAsync(IStorageFolder)	Sposta il file corrente nella cartella specificata.
MoveAsync(IStorageFolder, String)	Sposta il file corrente nella cartella specificata e rinomina il file in base al nome desiderato.
MoveAsync(IStorageFolder, String, NameCollisionOption)	Sposta il file corrente nella cartella specificata e rinomina il file in base al nome desiderato. Questo metodo specifica anche le operazioni da eseguire se un file con lo stesso nome esiste già nella cartella specificata.
OpenAsync(FileAccessMode)	Apre un flusso ad accesso casuale con le opzioni specificate sul file specificato.
OpenAsync(FileAccessMode, StorageOpenOptions)	Apre un flusso ad accesso casuale con le opzioni specificate sul file specificato.
OpenReadAsync()	Apre un flusso ad accesso casuale sul file corrente per la lettura del contenuto del file.
OpenSequentialReadAsync()	Apre un flusso di accesso sequenziale sul file corrente per la lettura del contenuto del file.
OpenTransactedWriteAsync()	Apre un flusso ad accesso casuale al file che può essere usato per le operazioni di scrittura transazionate.
OpenTransactedWriteAsync(StorageOpenOptions)	Apre un flusso ad accesso casuale al file che può essere usato per le operazioni di scrittura transazionate con le opzioni specificate.
RenameAsync(String)	Rinomina il file corrente.
RenameAsync(String, NameCollisionOption)	Rinomina il file corrente. Questo metodo specifica anche cosa fare se un elemento esistente nel percorso del file corrente ha lo stesso nome.
ReplaceWithStreamedFileAsync(IStorageFile, StreamedFileDataRequestedHandler, IRandomAccessStreamReference)	Sostituisce il contenuto del file a cui fa riferimento l'oggetto IStorageFile specificato con un nuovo flusso di dati. Questo metodo consente all'app di produrre i dati su richiesta specificando una funzione da richiamare quando si accede per la prima volta a StorageFile che rappresenta il flusso.
ReplaceWithStreamedFileFromUriAsync(IStorageFile, Uri, IRandomAccessStreamReference)	Sostituisce il contenuto del file a cui fa riferimento l'oggetto IStorageFile specificato con un nuovo flusso di dati dell'URI (Uniform Resource Identifier) specificato. Questo metodo consente all'app di scaricare i dati su richiesta quando si accede a StorageFile che rappresenta il flusso. L'accesso al flusso di dati viene eseguito tramite StorageFile restituito e i dati vengono scaricati su richiesta quando si accede per la prima volta a StorageFile . Sostituisce l'oggetto IStorageFile che rappresenta il file specificato con un nuovo Oggetto StorageFile che fornisce un flusso dell'URI (Uniform Resource Identifier) specificato.

Si applica a