Share via

KnownFolders.DocumentsLibrary Свойство

  • Ссылка

Определение

Пространство имен:
Windows.Storage
Изменить

Возвращает библиотеку документов. Библиотека документов не предназначена для общего использования.

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

Значение свойства

StorageFolder

Библиотека документов.

Требования к Windows

Возможности приложения
documentsLibrary

Комментарии

Важно!

Библиотека документов не предназначена для общего использования. Подробнее см. в разделе Объявления характеристик приложения;

Если вашему приложению необходимо создавать и обновлять файлы, которые использует только ваше приложение, рассмотрите возможность использования папки LocalCache приложения. Дополнительные сведения о папках, которые следует использовать для данных приложения, см. в разделе Класс ApplicationData .

Кроме того, пользователь может выбрать расположение файла с помощью средства выбора файлов. Дополнительные сведения см. в разделе Открытие файлов и папок с помощью средства выбора, в частности в свойствеSuggestedStartLocation , для которого можно задать значение DocumentsLibrary. Если пользователь выбирает библиотеку документов в средстве выбора, вам не нужно использовать это свойство и возможность documentsLibrary .

Предварительные требования

Чтобы получить доступ к библиотеке документов без использования средства выбора, выполните следующие действия.

  • В манифесте приложения укажите возможность библиотеки документов . Эта возможность не отображается в Designer манифеста. Чтобы добавить возможность библиотеки документов, откройте манифест приложения в представлении кода и измените XML-файл напрямую. Эта возможность не нужна при использовании средств выбора файлов.
  • В манифесте приложения зарегистрируйте по крайней мере одно объявление сопоставления типов файлов. Это объявление явно указывает типы файлов (расширения), к которым приложение хочет получить доступ в библиотеке документов. Приложение может перечислять, создавать или изменять только файлы, типы которых объявлены в манифесте приложения. Дополнительные сведения см. в разделе Обработка активации файла. Это объявление добавлять не нужно, если используются средства выбора файлов.

Возвращаемое значение

Для работы с библиотекой Documents и ее содержимым вызовите методы и свойства класса StorageFolder . Общие сведения об использовании файлов и папок см. в разделе Перечисление и запрос файлов и папок.

Применяется к