KnownFolders Classe

  • Referência

Definição

Namespace:
Windows.Storage
Editar

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 KnownFolders
Public Class KnownFolders
Herança
Object Platform::Object IInspectable KnownFolders
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute

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 .

Obter mais informações

Veja como acessar alguns outros locais comumente usados.

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.

Aplica-se a

Confira também