DownloadsFolder.CreateFileAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| CreateFileAsync(String) |
Cria um novo arquivo dentro da pasta Downloads. |
| CreateFileAsync(String, CreationCollisionOption) |
Cria um novo arquivo na pasta Downloads e especifica o que fazer se um arquivo com o mesmo nome já existir na pasta Downloads. |
CreateFileAsync(String)
Cria um novo arquivo dentro da pasta Downloads.
public:
static IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName);/// [Windows.Foundation.Metadata.Overload("CreateFileAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName);[Windows.Foundation.Metadata.Overload("CreateFileAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileAsync(string desiredName);function createFileAsync(desiredName)Public Shared Function CreateFileAsync (desiredName As String) As IAsyncOperation(Of StorageFile)Parâmetros
- 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
Quando esse método for concluído, ele retornará o novo arquivo como um objeto StorageFile .
- Atributos
Confira também
Aplica-se a
CreateFileAsync(String, CreationCollisionOption)
Cria um novo arquivo na pasta Downloads e especifica o que fazer se um arquivo com o mesmo nome já existir na pasta Downloads.
public:
static IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName, CreationCollisionOption option);/// [Windows.Foundation.Metadata.Overload("CreateFileWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
static IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName, CreationCollisionOption const& option);[Windows.Foundation.Metadata.Overload("CreateFileWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileAsync(string desiredName, CreationCollisionOption option);function createFileAsync(desiredName, option)Public Shared Function CreateFileAsync (desiredName As String, option As CreationCollisionOption) As IAsyncOperation(Of StorageFile)Parâmetros
- 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 que ele criou, você não pode especificar OpenIfExists ou ReplaceExisting para esse parâmetro.
Retornos
Quando esse método for concluído, ele retornará o novo arquivo como um objeto StorageFile .
- Atributos