DownloadsFolder.CreateFileForUserAsync Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| CreateFileForUserAsync(User, String) |
Создает новый файл в папке Downloads определенного пользователя. |
| CreateFileForUserAsync(User, String, CreationCollisionOption) |
Создает новый файл в папке Downloads определенного пользователя и указывает, что делать, если файл с таким именем уже существует в папке Загрузки. |
CreateFileForUserAsync(User, String)
Создает новый файл в папке Downloads определенного пользователя.
public:
static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName);/// [Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName);[Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName);function createFileForUserAsync(user, desiredName)Public Shared Function CreateFileForUserAsync (user As User, desiredName As String) As IAsyncOperation(Of StorageFile)Параметры
- user
- User
Пользователь, для которого создается файл.
- desiredName
-
String
Platform::String
winrt::hstring
Требуемое имя создаваемого файла.
Если файл с указанным именем уже существует, будет использоваться аналогичное, но уникальное имя. Например, если параметр desiredName имеет значение "MyFileName.jpg", а файл с таким именем уже существует в папке "Загрузки", будет создан новый файл с таким именем, как "MyFileName (1).jpg".
Возвращаемое значение
После завершения этого метода он возвращает новый файл в виде объекта StorageFile .
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v2.0)
|
См. также раздел
Применяется к
CreateFileForUserAsync(User, String, CreationCollisionOption)
Создает новый файл в папке Downloads определенного пользователя и указывает, что делать, если файл с таким именем уже существует в папке Загрузки.
public:
static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName, CreationCollisionOption option);/// [Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName, CreationCollisionOption const& option);[Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName, CreationCollisionOption option);function createFileForUserAsync(user, desiredName, option)Public Shared Function CreateFileForUserAsync (user As User, desiredName As String, option As CreationCollisionOption) As IAsyncOperation(Of StorageFile)Параметры
- user
- User
Пользователь, для которого создается файл.
- desiredName
-
String
Platform::String
winrt::hstring
Требуемое имя создаваемого файла.
Если в текущей папке уже есть файл с указанным desiredName, указанный параметр CreationCollisionOption определяет, как Windows реагирует на конфликт.
- option
- CreationCollisionOption
Значение перечисления, определяющее, как Windows отвечает, если desiredName совпадает с именем существующего файла в текущей папке.
Так как приложение может получать доступ только к файлам в папке Downloads указанного пользователя, для этого параметра нельзя указать OpenIfExists или ReplaceExisting .
Возвращаемое значение
После завершения этого метода он возвращает новый файл в виде объекта StorageFile .
- Атрибуты
Требования к Windows
| Семейство устройств |
Windows 10 (появилось в 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (появилось в v2.0)
|