StorageFile.CopyAsync Método

Referência

Definição

Namespace:: Windows.Storage

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

CopyAsync(IStorageFolder)	Cria uma cópia do arquivo na pasta especificada.
CopyAsync(IStorageFolder, String)	Cria uma cópia do arquivo na pasta especificada e renomeia a cópia.
CopyAsync(IStorageFolder, String, NameCollisionOption)	Cria uma cópia do arquivo na pasta especificada e renomeia a cópia. Esse método também especifica o que fazer se um arquivo com o mesmo nome já existir na pasta de destino.

CopyAsync(IStorageFolder)

Editar

Cria uma cópia do arquivo na pasta especificada.

public:
 virtual IAsyncOperation<StorageFile ^> ^ CopyAsync(IStorageFolder ^ destinationFolder) = CopyAsync;

/// [Windows.Foundation.Metadata.Overload("CopyOverloadDefaultNameAndOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CopyAsync(IStorageFolder const& destinationFolder);

[Windows.Foundation.Metadata.Overload("CopyOverloadDefaultNameAndOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CopyAsync(IStorageFolder destinationFolder);

function copyAsync(destinationFolder)

Public Function CopyAsync (destinationFolder As IStorageFolder) As IAsyncOperation(Of StorageFile)

Parâmetros

destinationFolder: IStorageFolder

A pasta de destino em que a cópia do arquivo é criada.

Retornos

IAsyncOperation<StorageFile>

Quando esse método for concluído, ele retornará um StorageFile que representa a cópia do arquivo criado no destinationFolder.

Implementações

CopyAsync(IStorageFolder)

Atributos: OverloadAttribute RemoteAsyncAttribute

Exceções

UnauthorizedAccessException

Você não tem permissão para copiar um arquivo para a pasta de destino.

Exemplos

O exemplo a seguir copia um arquivo para a pasta especificada e renomeia a cópia chamando o método CopyAsync(IStorageFolder, String, NameCollisionOption). Este exemplo especifica explicitamente um valor para a opção que substitui o arquivo na pasta de destino se um arquivo com o nome especificado já existir.

using Windows.Storage;
using System.Threading.Tasks;

// Get the app's temporary folder.
StorageFolder tempFolder = ApplicationData.Current.TemporaryFolder;

// Create a sample file in the temporary folder.
string newFileName = "test.txt";
StorageFile newFile = await tempFolder.CreateFileAsync(newFileName);

// Get the app's local folder to use as the destination folder.
StorageFolder localFolder = ApplicationData.Current.LocalFolder;

// Specify a new name for the copied file.
string renamedFileName = "renamed_test.txt";

// Copy the file to the destination folder and rename it.
// Replace the existing file if the file already exists.
StorageFile copiedFile = await newFile.CopyAsync(localFolder, renamedFileName, NameCollisionOption.ReplaceExisting);

IAsyncAction MainPage::CopyFileAsync()
{
    // Get the app's temporary folder.
    StorageFolder sourceFolder{ ApplicationData::Current().TemporaryFolder() };
    StorageFolder targetFolder{ ApplicationData::Current().LocalFolder() };

    // Choose source file name and new name for the copied file.
    std::wstring newFileName{ L"test.txt" };
    std::wstring copyFileName{ L"renamed_test.txt" };

    // Create a sample file in the temporary folder.
    StorageFile sourceFile{ co_await sourceFolder.CreateFileAsync(newFileName, Windows::Storage::CreationCollisionOption::ReplaceExisting) };
    // Overwrite any existing file with the same name.
    StorageFile copiedFile{ co_await sourceFile.CopyAsync(targetFolder, copyFileName, Windows::Storage::NameCollisionOption::ReplaceExisting) };
    // Do something with copied file.
}

//Get the app's temporary folder
StorageFolder^ sourceFolder = ApplicationData::Current->TemporaryFolder;
StorageFolder^ targetFolder = ApplicationData::Current->LocalFolder;

// Choose source file name and new name for the copied file
String^ newFileName = "test.txt";
String^ copyFileName = "renamed_test.txt";

//Create a sample file in the temporary folder
auto copyFileTask = create_task(sourceFolder->CreateFileAsync(newFileName, Windows::Storage::CreationCollisionOption::ReplaceExisting)).then
([targetFolder, copyFileName](StorageFile^ sourceFile) -> task<StorageFile^>
{
    //Overwrite any existing file with the same name 
    auto copyFileTask = sourceFile->CopyAsync(targetFolder, copyFileName, Windows::Storage::NameCollisionOption::ReplaceExisting);
    return create_task(copyFileTask);
}).then([](StorageFile^ copiedFile) {
    //do something with copied 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 de destino. Se você quiser lidar com uma colisão de nome de arquivo de uma maneira diferente, chame o método sobrecarregado CopyAsync(IStorageFolder, String, NameCollisionOption ).

Observação

Quando StorageFile.CopyAsync é usado para copiar um arquivo criptografado para um destino que não está criptografado, a chamada falhará com a seguinte exceção: System.UnauthorizedAccessException: Access is denied. (Excep_FromHResult 0x80070005)

Confira também

Aplica-se a

CopyAsync(IStorageFolder, String)

Editar

Cria uma cópia do arquivo na pasta especificada e renomeia a cópia.

public:
 virtual IAsyncOperation<StorageFile ^> ^ CopyAsync(IStorageFolder ^ destinationFolder, Platform::String ^ desiredNewName) = CopyAsync;

/// [Windows.Foundation.Metadata.Overload("CopyOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CopyAsync(IStorageFolder const& destinationFolder, winrt::hstring const& desiredNewName);

[Windows.Foundation.Metadata.Overload("CopyOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CopyAsync(IStorageFolder destinationFolder, string desiredNewName);

function copyAsync(destinationFolder, desiredNewName)

Public Function CopyAsync (destinationFolder As IStorageFolder, desiredNewName As String) As IAsyncOperation(Of StorageFile)

Parâmetros

destinationFolder: IStorageFolder

A pasta de destino em que a cópia do arquivo é criada.

desiredNewName: String
Platform::String

winrt::hstring

O novo nome para a cópia do arquivo criado no destinationFolder.

Retornos

IAsyncOperation<StorageFile>

Quando esse método for concluído, ele retornará um StorageFile que representa a cópia do arquivo criado no destinationFolder.

Observação

Implementações

M:Windows.Storage.IStorageFile.CopyAsync(Windows.Storage.IStorageFolder,System.String) M:Windows.Storage.IStorageFile.CopyAsync(Windows.Storage.IStorageFolder,Platform::String) M:Windows.Storage.IStorageFile.CopyAsync(Windows.Storage.IStorageFolder,winrt::hstring)

Atributos: OverloadAttribute RemoteAsyncAttribute

Exceções

UnauthorizedAccessException

Você não tem permissão para copiar um arquivo para a pasta de destino.

Confira também

Aplica-se a

CopyAsync(IStorageFolder, String, NameCollisionOption)

Editar

Cria uma cópia do arquivo na pasta especificada e renomeia a cópia. Esse método também especifica o que fazer se um arquivo com o mesmo nome já existir na pasta de destino.

public:
 virtual IAsyncOperation<StorageFile ^> ^ CopyAsync(IStorageFolder ^ destinationFolder, Platform::String ^ desiredNewName, NameCollisionOption option) = CopyAsync;

/// [Windows.Foundation.Metadata.Overload("CopyOverload")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CopyAsync(IStorageFolder const& destinationFolder, winrt::hstring const& desiredNewName, NameCollisionOption const& option);

[Windows.Foundation.Metadata.Overload("CopyOverload")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CopyAsync(IStorageFolder destinationFolder, string desiredNewName, NameCollisionOption option);

function copyAsync(destinationFolder, desiredNewName, option)

Public Function CopyAsync (destinationFolder As IStorageFolder, desiredNewName As String, option As NameCollisionOption) As IAsyncOperation(Of StorageFile)

Parâmetros

destinationFolder: IStorageFolder

A pasta de destino em que a cópia do arquivo é criada.

desiredNewName: String
Platform::String

winrt::hstring

O novo nome para a cópia do arquivo criado no destinationFolder.

option: NameCollisionOption

Um dos valores de enumeração que determina como lidar com a colisão se um arquivo com o DesiredNewName especificado já existir na pasta de destino.

Retornos

IAsyncOperation<StorageFile>

Quando esse método for concluído, ele retornará um StorageFile que representa a cópia do arquivo criado no destinationFolder.

Observação

Implementações

M:Windows.Storage.IStorageFile.CopyAsync(Windows.Storage.IStorageFolder,System.String,Windows.Storage.NameCollisionOption) M:Windows.Storage.IStorageFile.CopyAsync(Windows.Storage.IStorageFolder,Platform::String,Windows.Storage.NameCollisionOption) M:Windows.Storage.IStorageFile.CopyAsync(Windows.Storage.IStorageFolder,winrt::hstring,Windows.Storage.NameCollisionOption)

Atributos: OverloadAttribute RemoteAsyncAttribute

Exceções

UnauthorizedAccessException

Você não tem permissão para copiar um arquivo para a pasta de destino.

Confira também

Aplica-se a

Compartilhar via

StorageFile.CopyAsync Método

Definição

Sobrecargas

CopyAsync(IStorageFolder)

Parâmetros

Retornos

Implementações

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

CopyAsync(IStorageFolder, String)

Parâmetros

Retornos

Implementações

Exceções

Confira também

Aplica-se a

CopyAsync(IStorageFolder, String, NameCollisionOption)

Parâmetros

Retornos

Implementações

Exceções

Confira também

Aplica-se a

Comentários

Recursos adicionais