KnownFolders.DocumentsLibrary Propriedade

Definição

Namespace:

Windows.Storage

Obtém a biblioteca documentos. A biblioteca documentos não se destina ao uso geral.

public:
 static property StorageFolder ^ DocumentsLibrary { StorageFolder ^ get(); };

static StorageFolder DocumentsLibrary();

public static StorageFolder DocumentsLibrary { get; }

var storageFolder = KnownFolders.documentsLibrary;

Public Shared ReadOnly Property DocumentsLibrary As StorageFolder

Valor da propriedade

StorageFolder

A biblioteca documentos.

Requisitos do Windows

Funcionalidades do aplicativo

documentsLibrary

Comentários

Importante

A biblioteca documentos não se destina ao uso geral. Para saber mais, consulte Declarações de funcionalidades do aplicativo.

Se o aplicativo precisar criar e atualizar arquivos que somente seu aplicativo usa, considere usar a pasta LocalCache do aplicativo. Para obter mais informações sobre quais pastas você deve usar para os dados do aplicativo, consulte Classe ApplicationData .

Como alternativa, permita que o usuário selecione o local do arquivo usando um seletor de arquivos. Para obter mais informações, consulte Abrir arquivos e pastas com um seletor e, em particular, a SuggestedStartLocation propriedade que pode ser definida DocumentsLibrarycomo . Se o usuário selecionar a Biblioteca de Documentos de dentro do seletor, você não precisará usar essa propriedade nem a funcionalidade documentsLibrary .

Pré-requisitos

Para acessar a biblioteca de Documentos sem usar um seletor, faça o seguinte.

• No manifesto do aplicativo, especifique a funcionalidade Biblioteca de Documentos. Essa funcionalidade não está visível no manifesto Designer. Para adicionar a funcionalidade Biblioteca de Documentos, abra o manifesto do aplicativo na exibição de código e edite o XML diretamente. Você não precisará desse recurso se usar os seletores de arquivos.
• No manifesto do aplicativo, registre pelo menos uma declaração de Associação de Tipo de Arquivo. Essa declaração indica explicitamente os tipos de arquivo (extensões) que seu aplicativo deseja acessar na biblioteca documentos. O aplicativo só pode enumerar, criar ou alterar arquivos que têm os tipos de arquivo declarados no manifesto do aplicativo. Para obter mais informações, consulte Manipular ativação de arquivo. Você não precisará adicionar essa declaração se usar os seletores de arquivos.

Valor retornado

Para trabalhar com a biblioteca documentos e seu conteúdo, chame os métodos e as propriedades da classe StorageFolder . Para obter informações gerais sobre como usar arquivos e pastas, consulte Enumerar e consultar arquivos e pastas.