KnownFolders 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.
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.
public ref class KnownFolders abstract sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class KnownFolders final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class KnownFoldersPublic Class KnownFolders- Ereditarietà
- Attributi
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 accesso ai file illustra come utilizzare la proprietà PicturesLibrary per creare un nuovo file nella raccolta Immagini.
StorageFolder storageFolder = KnownFolders.PicturesLibrary;
StorageFile file = await storageFolder.CreateFileAsync("sample.png", CreationCollisionOption.ReplaceExisting);
// Do something with the new file.
Al termine del metodo CreateFileAsync , la file variabile contiene un oggetto StorageFile che rappresenta il nuovo file.
Commenti
Questa classe è statica e non può essere creata un'istanza. Accedere direttamente alle relative proprietà, come illustrato nell'esempio seguente.
StorageFolder storageFolder = KnownFolders.PicturesLibrary;
Prerequisiti
Per accedere alle cartelle e alle librerie rappresentate dalle proprietà di questa classe, specificare le funzionalità corrispondenti nel manifesto dell'app. Ad esempio, per accedere a KnownFolders.PicturesLibrary, specificare la funzionalità Raccolta immagini nel manifesto dell'app. Altre informazioni sulle funzionalità nelle dichiarazioni di funzionalità delle app.
Valore restituito
Le proprietà della classe KnownFolders restituiscono un oggetto StorageFolder. Per usare la cartella nota e il relativo contenuto, chiamare i metodi e le proprietà della classe StorageFolder .
- Per informazioni su come usare immagini, musica e video nella tua app, vedi Audio, video e fotocamera.
- Per informazioni generali su come usare file e cartelle, vedi Enumerare ed eseguire query su file e cartelle.
Altre informazioni
Ecco come accedere ad altre posizioni di uso comune.
- Ottenere la cartella locale dell'app dalla proprietà Windows.Storage.ApplicationData.Current.LocalFolder .
- Ottenere la cartella di installazione dell'app dalla proprietà Windows.ApplicationModel.Package.Current.InstalledLocation .
Per altre informazioni sui percorsi a cui l'app può accedere, vedere Autorizzazioni di accesso ai file.
Cronologia delle versioni
| Versione di Windows | Versione dell'SDK | Valore aggiunto |
|---|---|---|
| 1511 | 10586 | GetFolderForUserAsync |
| 2004 | 19041 | GetFolderAsync |
| 2004 | 19041 | RequestAccessAsync |
| 2004 | 19041 | RequestAccessForUserAsync |
Proprietà
| AppCaptures |
Ottiene la cartella Acquisizioni app. |
| CameraRoll |
Ottiene la cartella Camera Roll. |
| DocumentsLibrary |
Ottiene la raccolta Documenti. La raccolta Documenti non è destinata all'uso generale. |
| HomeGroup |
Ottiene la cartella HomeGroup. |
| MediaServerDevices |
Ottiene la cartella dei dispositivi del server multimediale (Digital Living Network Alliance)). |
| MusicLibrary |
Ottiene la libreria Music. |
| Objects3D |
Ottiene la cartella Objects 3D. |
| PicturesLibrary |
Ottiene la raccolta Immagini. |
| Playlists |
Ottiene la cartella degli elenchi di riproduzione. |
| RecordedCalls |
Ottiene la cartella delle chiamate registrate. |
| RemovableDevices |
Ottiene la cartella dispositivi rimovibili. |
| SavedPictures |
Ottiene la cartella Immagini salvate. |
| VideosLibrary |
Ottiene la raccolta Video. |
Metodi
| GetFolderAsync(KnownFolderId) |
Recupera la cartella per il folderId specificato. |
| GetFolderForUserAsync(User, KnownFolderId) |
Metodo statico che restituisce una cartella nota specificata per un utente. |
| RequestAccessAsync(KnownFolderId) |
Richiede l'accesso per la funzionalità che controlla l'accesso alla cartella. |
| RequestAccessForUserAsync(User, KnownFolderId) |
Richiede l'accesso per l'utente e folderId. |