StorageFolder.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 com o nome especificado na pasta atual. |
| CreateFileAsync(String, CreationCollisionOption) |
Cria um novo arquivo na pasta atual. Esse método também especifica o que fazer se um arquivo com o mesmo nome já existir na pasta atual. |
CreateFileAsync(String)
Cria um novo arquivo com o nome especificado na pasta atual.
public:
virtual IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName) = CreateFileAsync;/// [Windows.Foundation.Metadata.Overload("CreateFileAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName);[Windows.Foundation.Metadata.Overload("CreateFileAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CreateFileAsync(string desiredName);function createFileAsync(desiredName)Public Function CreateFileAsync (desiredName As String) As IAsyncOperation(Of StorageFile)Parâmetros
- desiredName
-
String
Platform::String
winrt::hstring
O nome do novo arquivo a ser criado na pasta atual.
Retornos
Quando esse método for concluído, ele retornará um StorageFile que representa o novo arquivo.
Implementações
- Atributos
Exceções
O nome do arquivo contém caracteres inválidos ou o formato do nome do arquivo está incorreto. Verifique o valor de desiredName.
Você não tem permissão para criar um arquivo na pasta atual.
Exemplos
O exemplo a seguir mostra como criar um novo arquivo na pasta atual chamando o método sobrecarregado CreateFileAsync (String, CreationCollisionOption). Este exemplo especifica explicitamente um valor para opções que fazem com que a operação falhe se um arquivo com o desiredName especificado já existir na pasta atual.
using Windows.Storage;
using System.Threading.Tasks;
// Get the app's local folder.
StorageFolder localFolder = Windows.Storage.ApplicationData.Current.LocalFolder;
// Create a new file in the current folder.
// Raise an exception if the file already exists.
string desiredName = "test.txt";
StorageFile newFile = await localFolder.CreateFileAsync(desiredName, CreationCollisionOption.FailIfExists);
IAsyncAction MainPage::ExampleCoroutineAsync()
{
// Gets the app's local folder.
Windows::Storage::StorageFolder localFolder{ Windows::Storage::ApplicationData::Current().LocalFolder() };
// Create a new file in the current folder, and throw an exception if the file already exists.
std::wstring desiredName{ L"test.txt" };
StorageFile newFile{ co_await localFolder.CreateFileAsync(desiredName, Windows::Storage::CreationCollisionOption::FailIfExists) };
// Do something with the new file.
}
//Gets the app's local folder
StorageFolder^ localFolder = ApplicationData::Current->LocalFolder;
//Create a new file in the current folder
// Raise an exception if the file already exists
String^ desiredName = "test.txt";
auto createFileTask = create_task(localFolder->CreateFileAsync(desiredName, Windows::Storage::CreationCollisionOption::FailIfExists));
createFileTask.then([](StorageFile^ newFile)
{
//Do something with the new file.
});
Comentários
Esse método usa o valor FailIfExists da enumeração CreationCollisionOption por padrão. Ou seja, esse método gerará uma exceção se um arquivo com o mesmo nome já existir na pasta atual. Se você quiser lidar com uma colisão de nome de arquivo de uma maneira diferente, chame o método CreateFileAsync(String, CreationCollisionOption).
Se você tentar criar um arquivo em uma pasta virtual como uma biblioteca ou uma pasta que represente um contêiner para um grupo de arquivos (por exemplo, o valor retornado de algumas sobrecargas do método GetFoldersAsync ), o método CreateFileAsync poderá falhar.
Confira também
Aplica-se a
CreateFileAsync(String, CreationCollisionOption)
Cria um novo arquivo na pasta atual. Esse método também especifica o que fazer se um arquivo com o mesmo nome já existir na pasta atual.
public:
virtual IAsyncOperation<StorageFile ^> ^ CreateFileAsync(Platform::String ^ desiredName, CreationCollisionOption options) = CreateFileAsync;/// [Windows.Foundation.Metadata.Overload("CreateFileAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CreateFileAsync(winrt::hstring const& desiredName, CreationCollisionOption const& options);[Windows.Foundation.Metadata.Overload("CreateFileAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CreateFileAsync(string desiredName, CreationCollisionOption options);function createFileAsync(desiredName, options)Public Function CreateFileAsync (desiredName As String, options As CreationCollisionOption) As IAsyncOperation(Of StorageFile)Parâmetros
- desiredName
-
String
Platform::String
winrt::hstring
O nome do novo arquivo a ser criado na pasta atual.
- options
- CreationCollisionOption
Um dos valores de enumeração que determina como lidar com a colisão se um arquivo com o desiredName especificado já existir na pasta atual.
Retornos
Quando esse método for concluído, ele retornará um StorageFile que representa o novo arquivo.
Implementações
- Atributos
Exceções
Você especificou CreationCollisionOption.FailIfExists e um arquivo com o desiredName especificado já existe na pasta atual.
O formato do nome do arquivo está incorreto. Verifique o valor de desiredName.
Você não tem permissão para criar um arquivo na pasta atual.
Confira também
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de