StorageFolder.RenameAsync Metode

Definisi

Overload

RenameAsync(String)

Mengganti nama folder saat ini.

RenameAsync(String, NameCollisionOption)

Mengganti nama folder saat ini dan menentukan apa yang harus dilakukan jika folder dengan nama yang sama sudah ada.

RenameAsync(String)

Mengganti nama folder saat ini.

public:
 virtual IAsyncAction ^ RenameAsync(Platform::String ^ desiredName) = RenameAsync;
/// [Windows.Foundation.Metadata.Overload("RenameAsyncOverloadDefaultOptions")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction RenameAsync(winrt::hstring const& desiredName);
[Windows.Foundation.Metadata.Overload("RenameAsyncOverloadDefaultOptions")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction RenameAsync(string desiredName);
function renameAsync(desiredName)
Public Function RenameAsync (desiredName As String) As IAsyncAction

Parameter

desiredName
String

Platform::String

winrt::hstring

Nama baru yang diinginkan untuk folder saat ini.

Mengembalikan

Tidak ada objek atau nilai yang dikembalikan oleh metode ini ketika selesai.

Penerapan

M:Windows.Storage.IStorageItem.RenameAsync(System.String) M:Windows.Storage.IStorageItem.RenameAsync(Platform::String) M:Windows.Storage.IStorageItem.RenameAsync(winrt::hstring)
Atribut

Keterangan

Jika nama yang Anda tentukan tidak valid, metode ini (dan kelebihan bebannya) akan memberikan pengecualian. Untuk menangani semua cara nama yang ditentukan bisa tidak valid, Anda harus menangkap keempat pengecualian ini:

E_INVALIDARG
E_FAIL
ERROR_FILENAME_EXCED_RANGE
ERROR_INVALID_NAME

Jika file dihapus sebelum penggantian nama selesai, metode ini akan menampilkan pengecualian ERROR_FILE_NOT_FOUND. Anda juga harus menangkap dan menangani pengecualian ini ketika Anda menggunakan metode ini.

Lihat juga

Berlaku untuk

RenameAsync(String, NameCollisionOption)

Mengganti nama folder saat ini dan menentukan apa yang harus dilakukan jika folder dengan nama yang sama sudah ada.

public:
 virtual IAsyncAction ^ RenameAsync(Platform::String ^ desiredName, NameCollisionOption option) = RenameAsync;
/// [Windows.Foundation.Metadata.Overload("RenameAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncAction RenameAsync(winrt::hstring const& desiredName, NameCollisionOption const& option);
[Windows.Foundation.Metadata.Overload("RenameAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncAction RenameAsync(string desiredName, NameCollisionOption option);
function renameAsync(desiredName, option)
Public Function RenameAsync (desiredName As String, option As NameCollisionOption) As IAsyncAction

Parameter

desiredName
String

Platform::String

winrt::hstring

Nama baru yang diinginkan untuk folder saat ini.

Jika ada item yang ada di lokasi folder saat ini yang sudah memiliki desiredName yang ditentukan, NameCollisionOption yang ditentukan menentukan bagaimana Windows merespons konflik.

option
NameCollisionOption

Nilai enum yang menentukan bagaimana Windows merespons jika desiredName sama dengan nama item yang ada di lokasi folder saat ini.

Mengembalikan

Tidak ada objek atau nilai yang dikembalikan oleh metode ini ketika selesai.

Penerapan

M:Windows.Storage.IStorageItem.RenameAsync(System.String,Windows.Storage.NameCollisionOption) M:Windows.Storage.IStorageItem.RenameAsync(Platform::String,Windows.Storage.NameCollisionOption) M:Windows.Storage.IStorageItem.RenameAsync(winrt::hstring,Windows.Storage.NameCollisionOption)
Atribut

Lihat juga

Berlaku untuk