IStorageItem.RenameAsync Metode

Definisi

Ruang nama:

Windows.Storage

Overload

RenameAsync(String)	Mengganti nama item saat ini.
RenameAsync(String, NameCollisionOption)	Mengganti nama item saat ini. Metode ini juga menentukan apa yang harus dilakukan jika item yang ada di lokasi item saat ini memiliki nama yang sama.

RenameAsync(String)

Mengganti nama item saat ini.

public:
 IAsyncAction ^ RenameAsync(Platform::String ^ desiredName);

/// [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 item yang diinginkan.

Mengembalikan

IAsyncAction

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

Atribut

OverloadAttribute RemoteAsyncAttribute

Keterangan

Untuk metode ini dan kelebihan bebannya, jika nama yang Anda tentukan tidak valid, metode ini 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 item saat ini. Metode ini juga menentukan apa yang harus dilakukan jika item yang ada di lokasi item saat ini memiliki nama yang sama.

public:
 IAsyncAction ^ RenameAsync(Platform::String ^ desiredName, NameCollisionOption option);

/// [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 item saat ini.

Jika ada item yang ada di lokasi item 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 item saat ini.

Mengembalikan

IAsyncAction

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

Atribut

OverloadAttribute RemoteAsyncAttribute

Lihat juga

• RenameAsync(String)