KnownFolders Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece acesso a locais comuns que contêm conteúdo do usuário. Isso inclui conteúdo das bibliotecas locais de um usuário (como Documentos, Imagens, Música e Vídeos), Grupo Doméstico, dispositivos removíveis e dispositivos de servidor de mídia.
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- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Exemplos
O exemplo de acesso ao arquivo mostra como usar a propriedade PicturesLibrary para criar um novo arquivo na biblioteca Imagens.
StorageFolder storageFolder = KnownFolders.PicturesLibrary;
StorageFile file = await storageFolder.CreateFileAsync("sample.png", CreationCollisionOption.ReplaceExisting);
// Do something with the new file.
Após a conclusão do método CreateFileAsync , a file variável contém um StorageFile que representa o novo arquivo.
Comentários
Essa classe é estática e não pode ser instanciada. Acesse suas propriedades diretamente, conforme mostrado no exemplo a seguir.
StorageFolder storageFolder = KnownFolders.PicturesLibrary;
Pré-requisitos
Para acessar as pastas e bibliotecas representadas pelas propriedades dessa classe, especifique os recursos correspondentes no manifesto do aplicativo. Por exemplo, para acessar KnownFolders.PicturesLibrary, especifique a funcionalidade Biblioteca de Imagens no manifesto do aplicativo. Saiba mais sobre os recursos nas declarações de funcionalidade do aplicativo.
Valor retornado
As propriedades da classe KnownFolders retornam um StorageFolder. Para trabalhar com a pasta conhecida e seu conteúdo, chame os métodos e as propriedades da classe StorageFolder .
- Para obter informações sobre como usar imagens, músicas e vídeos em seu aplicativo, consulte Áudio, vídeo e câmera.
- Para obter informações gerais sobre como usar arquivos e pastas, consulte Enumerar e consultar arquivos e pastas.
Obter mais informações
Veja como acessar alguns outros locais comumente usados.
- Obtenha a pasta local do aplicativo da propriedade Windows.Storage.ApplicationData.Current.LocalFolder .
- Obtenha a pasta de instalação do aplicativo da propriedade Windows.ApplicationModel.Package.Current.InstalledLocation .
Para saber mais sobre os locais que seu aplicativo pode acessar, consulte Permissões de acesso a arquivos.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1511 | 10586 | GetFolderForUserAsync |
| 2004 | 19041 | GetFolderAsync |
| 2004 | 19041 | RequestAccessAsync |
| 2004 | 19041 | RequestAccessForUserAsync |
Propriedades
| AppCaptures |
Obtém a pasta Capturas de Aplicativo. |
| CameraRoll |
Obtém a pasta Imagens da Câmera. |
| DocumentsLibrary |
Obtém a biblioteca documentos. A biblioteca documentos não se destina ao uso geral. |
| HomeGroup |
Obtém a pasta HomeGroup. |
| MediaServerDevices |
Obtém a pasta de dispositivos de servidor de mídia (DLNA (Digital Living Network Alliance). |
| MusicLibrary |
Obtém a biblioteca música. |
| Objects3D |
Obtém a pasta Objetos 3D. |
| PicturesLibrary |
Obtém a biblioteca Imagens. |
| Playlists |
Obtém a pasta listas de reprodução. |
| RecordedCalls |
Obtém a pasta de chamadas gravadas. |
| RemovableDevices |
Obtém a pasta de dispositivos removíveis. |
| SavedPictures |
Obtém a pasta Imagens Salvas. |
| VideosLibrary |
Obtém a biblioteca vídeos. |
Métodos
| GetFolderAsync(KnownFolderId) |
Recupera a pasta para a folderId especificada. |
| GetFolderForUserAsync(User, KnownFolderId) |
Método estático que retorna uma pasta conhecida especificada para um Usuário. |
| RequestAccessAsync(KnownFolderId) |
Solicita acesso para a funcionalidade que controla o acesso à pasta. |
| RequestAccessForUserAsync(User, KnownFolderId) |
Solicita acesso para o usuário e folderId. |