DownloadsFolder.CreateFileForUserAsync Método

  • Referência

Definição

Namespace:
Windows.Storage

Sobrecargas

CreateFileForUserAsync(User, String)

Cria um novo arquivo dentro da pasta Downloads de um usuário específico.
CreateFileForUserAsync(User, String, CreationCollisionOption)

Cria um novo arquivo na pasta Downloads de um Usuário específico e especifica o que fazer se um arquivo com o mesmo nome já existir na pasta Downloads.

CreateFileForUserAsync(User, String)

Editar

Cria um novo arquivo dentro da pasta Downloads de um usuário específico.

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)

Parâmetros

user
User

O Usuário para o qual o arquivo é criado.

desiredName
String

Platform::String

winrt::hstring

O nome desejado do arquivo a ser criado.

Se já existir um arquivo com o nome especificado, um nome semelhante, mas exclusivo, será usado. Por exemplo, se desiredName for "MyFileName.jpg" e um arquivo com esse nome já existir na pasta Downloads, o novo arquivo será criado com um nome como "MyFileName (1).jpg".

Retornos

IAsyncOperation<StorageFile>

Quando esse método for concluído, ele retornará o novo arquivo como um objeto StorageFile .

Atributos
OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v2.0)

Confira também

Aplica-se a

CreateFileForUserAsync(User, String, CreationCollisionOption)

Editar

Cria um novo arquivo na pasta Downloads de um Usuário específico e especifica o que fazer se um arquivo com o mesmo nome já existir na pasta 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)

Parâmetros

user
User

O Usuário para o qual o arquivo é criado.

desiredName
String

Platform::String

winrt::hstring

O nome desejado do arquivo a ser criado.

Se houver um arquivo existente na pasta atual que já tenha o desiredName especificado, o CreationCollisionOption especificado determinará como o Windows responde ao conflito.

option
CreationCollisionOption

O valor de enumeração que determina como o Windows responde se desiredName é o mesmo que o nome de um arquivo existente na pasta atual.

Como o aplicativo só pode acessar arquivos na pasta Downloads do Usuário especificado, você não pode especificar OpenIfExists ou ReplaceExisting para esse parâmetro.

Retornos

IAsyncOperation<StorageFile>

Quando esse método for concluído, ele retornará o novo arquivo como um objeto StorageFile .

Atributos
OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v2.0)

Confira também

Aplica-se a