StorageFile.RenameAsync Metode

Definisi

Ruang nama:

Windows.Storage

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

IAsyncAction

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

OverloadAttribute RemoteAsyncAttribute

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

• RenameAsync(String, NameCollisionOption)

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

IAsyncAction

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

OverloadAttribute RemoteAsyncAttribute

Lihat juga

• RenameAsync(String)