DownloadsFolder Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Создает файлы и папки в папке Загрузки.
public ref class DownloadsFolder abstract sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class DownloadsFolder final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public static class DownloadsFolderPublic Class DownloadsFolder- Наследование
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Примеры
Пустой файл можно создать в папке Загрузки следующим образом:
StorageFile file = await Windows.Storage.DownloadsFolder.CreateFileAsync("sample.txt");
// Process file
После завершения filecreateFileAsync получает новый файл как StorageFile.
Комментарии
Этот класс является статическим и не может быть создан. Вместо этого вызовите методы напрямую.
Разрешения для файлов и папок в папке "Загрузки"
Все приложения могут создавать файлы и папки в папке "Загрузки" и получать доступ к создаваемым ими файлам. Но приложения не могут получить доступ к файлам в папке "Загрузки", которую они не создали.
Когда приложение создает файл в папке "Загрузки", другие приложения не могут вмешиваться в файл или получать к ним доступ, если пользователь явно не предоставит доступ к другому приложению. Пользователь может предоставить другому приложению доступ к файлу, выбрав файл в средстве выбора файлов. Приложение также может использовать средство выбора файлов, чтобы получить доступ к файлам в папке "Загрузки", которую оно не создавало. Дополнительные сведения об открытии файлов с помощью средства выбора файлов см. в статье Открытие файлов и папок с помощью средства выбора.
Возможности не требуются для создания файлов или доступа к файлам в папке "Загрузки". Дополнительные сведения о возможностях см. в статье Объявления возможностей приложений.
Дополнительные сведения о том, к каким расположениям может получить приложение, см. в разделе Разрешения на доступ к файлам.
Журнал версий
| Версия Windows | Версия пакета SDK | Добавленная стоимость |
|---|---|---|
| 1511 | 10586 | CreateFileForUserAsync(User,String) |
| 1511 | 10586 | CreateFileForUserAsync(User,String,CreationCollisionOption) |
| 1511 | 10586 | CreateFolderForUserAsync(User,String) |
| 1511 | 10586 | CreateFolderForUserAsync(User,String,CreationCollisionOption) |
Методы
| CreateFileAsync(String) |
Создает новый файл в папке Загрузки. |
| CreateFileAsync(String, CreationCollisionOption) |
Создает новый файл в папке Загрузки и указывает, что делать, если файл с таким именем уже существует в папке Загрузки. |
| CreateFileForUserAsync(User, String) |
Создает новый файл в папке Downloads определенного пользователя. |
| CreateFileForUserAsync(User, String, CreationCollisionOption) |
Создает новый файл в папке Downloads определенного пользователя и указывает, что делать, если файл с таким именем уже существует в папке Загрузки. |
| CreateFolderAsync(String) |
Создает новую вложенную папку в папке Загрузки. |
| CreateFolderAsync(String, CreationCollisionOption) |
Создает новую вложенную папку в папке Загрузки и указывает, что делать, если вложенная папка с таким именем уже существует в папке Downloads. |
| CreateFolderForUserAsync(User, String) |
Создает новую вложенную папку в папке Downloads определенного пользователя. |
| CreateFolderForUserAsync(User, String, CreationCollisionOption) |
Создает новую вложенную папку в папке Downloads определенного пользователя и указывает, что делать, если вложенная папка с таким именем уже существует в папке Загрузки. |