KnownFolders 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

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 KnownFolders

Public Class KnownFolders

Ereditarietà: Object Platform::Object IInspectable KnownFolders

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute

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.

Si applica a