Тип ресурса SpecialFolder

  • Статья

Ресурс SpecialFolder группирует элементы данных, связанные со специальной папкой, в единую структуру.

Если у элемента DriveItem есть аспект specialFolder, значение которого не равно null, то элемент представляет специальную (именованную) папку. Прямой доступ к специальным папкам можно получить с помощью коллекции специальных папок.

Специальные папки предоставляют простые псевдонимы для доступа к известным папкам, чтобы не нужно было искать папку по пути (что требует локализации) или ссылаться на папку по идентификатору. При переименовании специальной папки или ее перемещении в другое расположение на диске команда с таким синтаксисом будет по-прежнему возвращать эту папку.

Когда приложение впервые пробует записать что-то в специальную папку, она создается автоматически, если не была создана ранее. Если пользователь удалил такую папку, она создается повторно при записи в нее.

Примечание. Если ваше приложение запросило только область Files.Read и запрашивает специальную папку, которая не существует, в качестве отклика будет возвращена ошибка 403 Forbidden.

Представление JSON

{
  "name": "string"
}

Свойства

Свойство Тип Описание
name string Уникальный идентификатор для этого элемента в коллекции /drive/special.

Специальные папки

Ниже приведены специальные папки, доступные в OneDrive и OneDrive для бизнеса.

Имя Идентификатор папки Описание
Корневая папка приложения approot Личная папка приложения. Обычно расположена в папке /Apps/{Application Name}
Альбом камеры cameraroll Папка для резервных копий альбома камеры.
Рабочий стол desktop Папка "Рабочий стол".
Документы documents Папка "Документы".
Музыка music Папка "Музыка".
Фотографии photos Папка "Фотографии".

Заметки

Дополнительные сведения об аспектах ресурса DriveItem см. в описании типа DriveItem.