StorageFile.RenameAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
RenameAsync(String) |
Mengganti nama file saat ini. |
RenameAsync(String, NameCollisionOption) |
Mengganti nama file saat ini. Metode ini juga menentukan apa yang harus dilakukan jika item yang ada di lokasi file saat ini memiliki nama yang sama. |
RenameAsync(String)
Mengganti nama file 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 dari item saat ini.
Mengembalikan
Tidak ada objek atau nilai yang dikembalikan oleh metode ini ketika selesai.
Penerapan
- Atribut
Keterangan
Jika nama yang Anda tentukan tidak valid, metode ini 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 file saat ini. Metode ini juga menentukan apa yang harus dilakukan jika item yang ada di lokasi file saat ini memiliki nama yang sama.
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 dari file saat ini.
Jika ada item yang ada di lokasi file 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 file saat ini.
Mengembalikan
Tidak ada objek atau nilai yang dikembalikan oleh metode ini ketika selesai.
Penerapan
- Atribut