Windows.Storage Spazio dei nomi
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.
Fornisce classi per la gestione di file, cartelle e impostazioni dell'applicazione.
Per informazioni su come usare gli oggetti nella Windows. Spazio dei nomi di archiviazione, vedere le sezioni seguenti.
Classi
| Nome | Descrizione |
|---|---|
| AppDataPaths |
AppDataPaths restituisce i percorsi alle cartelle dell'applicazione di uso comune in base al modello di denominazione KNOWNFOLDERID . |
| ApplicationData |
Fornisce l'accesso all'archivio dati dell'applicazione. I dati dell'applicazione sono costituiti da file e impostazioni locali, mobili o temporanei. |
| ApplicationDataCompositeValue |
Rappresenta le impostazioni dell'app correlate che devono essere serializzate e deserializzate in modo atomico. |
| ApplicationDataContainer |
Rappresenta un contenitore per le impostazioni dell'app. I metodi e le proprietà di questa classe supportano la creazione, l'eliminazione, l'enumerazione e l'attraversamento della gerarchia dei contenitori. |
| ApplicationDataContainerSettings |
Fornisce l'accesso alle impostazioni in un contenitore di impostazioni. La proprietà ApplicationDataContainer.Values restituisce un oggetto di cui è possibile eseguire il cast a questo tipo. |
| CachedFileManager |
Consente alle app di gestire gli aggiornamenti in tempo reale per i file. |
| DownloadsFolder |
Crea file e cartelle all'interno della cartella Download. |
| FileIO |
Fornisce metodi helper per la lettura e la scrittura di file rappresentati da oggetti di tipo IStorageFile. |
| KnownFolders |
Fornisce l'accesso a percorsi comuni che contengono contenuto utente. Sono inclusi i contenuti delle raccolte locali di un utente (ad esempio Documenti, Immagini, Musica e Video), Gruppo Home, dispositivi rimovibili e dispositivi server multimediali. |
| PathIO |
Fornisce metodi helper per la lettura e la scrittura di un file usando il percorso assoluto o l'URI (Uniform Resource Identifier) del file. |
| SetVersionDeferral |
Gestisce un'operazione di versione set ritardata. |
| SetVersionRequest |
Fornisce i dati quando un'app imposta la versione dei dati dell'applicazione nell'archivio dati dell'app. |
| StorageFile |
Rappresenta un file. Fornisce informazioni sul file e sul relativo contenuto e sui modi per modificarli. |
| StorageFolder |
Gestisce le cartelle e il relativo contenuto e fornisce informazioni su di essi. |
| StorageLibrary |
Consente di aggiungere e rimuovere cartelle da una raccolta come Musica o Video e consente di ottenere un elenco di cartelle incluse nella raccolta. |
| StorageLibraryChange |
Rappresenta una modifica a un elemento in una raccolta di archiviazione, ad esempio documenti, musica o raccolta video. |
| StorageLibraryChangeReader |
Consente all'app chiamante di leggere le modifiche apportate agli elementi in una libreria di archiviazione. |
| StorageLibraryChangeTracker |
Fornisce API che è possibile usare per gestire il rilevamento delle modifiche per qualsiasi raccolta (ad esempio documenti, musica o video) o cartella. |
| StorageLibraryChangeTrackerOptions |
Consente ai chiamanti di chiamare EnableWithOptions nel rilevamento modifiche per scegliere di tenere traccia di tutte le modifiche, incluso l'ultimo ID modifica o solo l'ultimo ID modifica. |
| StorageLibraryLastChangeId |
Consente di tenere traccia delle modifiche in base a un valore univoco che rappresenta l'ultima modifica elaborata dal servizio di indicizzazione per l'oggetto StorageFolder o StorageLibrary specificato. |
| StorageProvider |
Contiene informazioni sul servizio che archivia file e cartelle. I file e le cartelle possono essere archiviati dal file system locale o da un servizio remoto come Microsoft OneDrive. |
| StorageStreamTransaction |
Rappresenta una transazione di scrittura per un flusso ad accesso casuale. |
| StreamedFileDataRequest |
Rappresenta un flusso di output di accesso sequenziale che indica una richiesta per il flusso di dati di un oggetto StorageFile creato chiamando CreateStreamedFileAsync o ReplaceWithStreamedFileAsync. |
| SystemAudioProperties |
Oggetto helper che fornisce nomi di indicizzazione per Windows proprietà del file audio. |
| SystemDataPaths |
Ottiene alcuni percorsi delle cartelle a livello di sistema comunemente usati in base al modello di denominazione KNOWNFOLDERID . |
| SystemGPSProperties |
Oggetto helper che fornisce i nomi di indicizzazione per le proprietà del file GPS. |
| SystemImageProperties |
Oggetto helper che fornisce nomi di indicizzazione per Windows proprietà del file di immagine. |
| SystemMediaProperties |
Oggetto helper che fornisce nomi di indicizzazione per Windows proprietà del file multimediale. |
| SystemMusicProperties |
Oggetto helper che fornisce nomi di indicizzazione per Windows proprietà dei file musicali. |
| SystemPhotoProperties |
Oggetto helper che fornisce nomi di indicizzazione per Windows proprietà del file fotografico. |
| SystemProperties |
Fornisce valori stringa per l'indicizzazione dei nomi di proprietà di file Windows comuni, ad esempio System.Title, e fa riferimento anche agli oggetti helper che forniscono nomi di indicizzazione per proprietà di tipi di file specifici ,ad esempio file video. |
| SystemVideoProperties |
Oggetto helper che fornisce nomi di indicizzazione per le proprietà dei file video. |
| UserDataPaths |
Restituisce percorsi completi per le cartelle di dati utente comuni. Le cartelle dati utente si basano sul modello di denominazione KNOWNFOLDERID . |
Interfacce
| Nome | Descrizione |
|---|---|
| IStorageFile |
Rappresenta un file. Fornisce informazioni sul file e sul relativo contenuto e sui modi per modificarli.
|
| IStorageFile2 |
Rappresenta un file. Fornisce informazioni sul file e sul relativo contenuto e sui modi per modificarli.
|
| IStorageFilePropertiesWithAvailability |
Fornisce l'accesso alla proprietà IsAvailable . |
| IStorageFolder |
Modifica le cartelle e il relativo contenuto e fornisce informazioni su di esse.
|
| IStorageFolder2 |
Modifica le cartelle e il relativo contenuto e fornisce informazioni su di esse. Importante Se vuoi semplicemente usare le cartelle nell'app, vedi la classe StorageFolder . |
| IStorageItem |
Modifica gli elementi di archiviazione (file e cartelle) e il relativo contenuto e fornisce informazioni su di essi.
|
| IStorageItem2 |
Modifica gli elementi di archiviazione (file e cartelle) e il relativo contenuto e fornisce informazioni su di essi.
|
| IStorageItemProperties |
Fornisce l'accesso alle proprietà comuni e del contenuto sugli elementi ,ad esempio file e cartelle. |
| IStorageItemProperties2 |
Fornisce l'accesso ai metodi che ottengono un'immagine ridimensionata come anteprima. |
| IStorageItemPropertiesWithProvider |
Fornisce l'accesso alle proprietà comuni e del contenuto per gli elementi di archiviazione di un provider specifico. |
| IStreamedFileDataRequest |
Rappresenta un flusso di output di accesso sequenziale che indica una richiesta per il flusso di dati di un oggetto StorageFile creato chiamando CreateStreamedFileAsync o ReplaceWithStreamedFileAsync. |
Enumerazioni
| Nome | Descrizione |
|---|---|
| ApplicationDataCreateDisposition |
Specifica le opzioni per la creazione di contenitori di dati dell'applicazione o la restituzione di contenitori esistenti. Questa enumerazione viene utilizzata dal metodo ApplicationDataContainer.CreateContainer . |
| ApplicationDataLocality |
Specifica il tipo di un archivio dati dell'applicazione. |
| CreationCollisionOption |
Specifica cosa fare se nella cartella corrente esiste già un file o una cartella con il nome specificato quando si crea un nuovo file o una nuova cartella. |
| FileAccessMode |
Specifica se accedere a un file in modalità di sola lettura o in modalità di lettura/scrittura. |
| FileAttributes |
Descrive gli attributi di un file o di una cartella. |
| KnownFolderId |
Fornisce valori che identificano le cartelle di archiviazione. |
| KnownFoldersAccessStatus |
Descrive l'accesso di una cartella nota a una singola funzionalità. |
| KnownLibraryId |
Fornisce valori che identificano le librerie di archiviazione. |
| NameCollisionOption |
Specifica le operazioni da eseguire se esiste già un file o una cartella con il nome specificato nella cartella corrente quando si copia, si sposta o si rinomina un file o una cartella. |
| StorageDeleteOption |
Specifica se un elemento eliminato viene spostato nel Cestino o eliminato definitivamente. |
| StorageItemTypes |
Descrive se un elemento che implementa l'interfaccia IStorageItem è un file o una cartella. |
| StorageLibraryChangeType |
Descrive il tipo di modifica apportata all'elemento della libreria di archiviazione. |
| StorageOpenOptions |
Fornisce opzioni da utilizzare quando si apre un file. |
| StreamedFileFailureMode |
Indica il motivo per cui non è stato possibile trasmettere i dati. |
Delegati
| Nome | Descrizione |
|---|---|
| ApplicationDataSetVersionHandler |
Rappresenta un metodo che gestisce la richiesta per impostare la versione dei dati dell'applicazione nell'archivio dati dell'applicazione. |
| StreamedFileDataRequestedHandler |
Rappresenta il metodo che trasmetterà i dati in un oggetto StorageFile quando si accede per la prima volta a tale file. |
Commenti
Annotazioni
Compatibilità del framework app: Windows. Le API di archiviazione sono disponibili per le app desktop di SDK per app di Windows (WinUI 3) e le app desktop Win32, non solo per le app UWP. Le app desktop possono usare classi come StorageFile, StorageFolder e ApplicationData tramite C#/WinRT o C++/WinRT. Alcune API, ad esempio la selezione file, richiedono una configurazione aggiuntiva nelle app desktop non in pacchetto. Per informazioni dettagliate, vedere Chiamare le API Windows Runtime nelle app desktop.
Vedi anche
- Esempio di accesso ai file (Windows 10)
- Esempio di enumerazione cartella (Windows 10)
- Esempio di creazione di immagini semplice (Windows 10)
- Esempio di selezione file (Windows 10)
- Esempio di ricerca di file (Windows 10)
- Esempio di anteprima di file e cartelle (Windows 10)
- Esempio di gestione delle librerie (Windows 10)
- Esempio di trasferimento in background
- Esempio di trasferimento in background (Windows 8.x)
- Esempio di indicizzatore di contenuto
- Esempio di serializzazione e deserializzazione dei dati
- Esempio di HomeGroup
- Esempio end-to-end del lettore RSS (JavaScript)