DownloadsFolder.CreateFileForUserAsync Metode

  • Referensi

Definisi

Ruang nama:
Windows.Storage

Overload

CreateFileForUserAsync(User, String)

Membuat file baru di dalam folder Unduhan Pengguna tertentu.
CreateFileForUserAsync(User, String, CreationCollisionOption)

Membuat file baru di folder Unduhan Pengguna tertentu, dan menentukan apa yang harus dilakukan jika file dengan nama yang sama sudah ada di folder Unduhan.

CreateFileForUserAsync(User, String)

Edit

Membuat file baru di dalam folder Unduhan Pengguna tertentu.

public:
 static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName);
/// [Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName);
[Windows.Foundation.Metadata.Overload("CreateFileForUserAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName);
function createFileForUserAsync(user, desiredName)
Public Shared Function CreateFileForUserAsync (user As User, desiredName As String) As IAsyncOperation(Of StorageFile)

Parameter

user
User

Pengguna tempat file dibuat.

desiredName
String

Platform::String

winrt::hstring

Nama file yang diinginkan untuk dibuat.

Jika file dengan nama yang ditentukan sudah ada, nama yang serupa tetapi unik akan digunakan. Misalnya, jika desiredName adalah "MyFileName.jpg" dan file dengan nama tersebut sudah ada di folder Unduhan, file baru akan dibuat dengan nama seperti "MyFileName (1).jpg" sebagai gantinya.

Mengembalikan

IAsyncOperation<StorageFile>

Ketika metode ini selesai, ia mengembalikan file baru sebagai objek StorageFile .

Atribut
OverloadAttribute RemoteAsyncAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v2.0)

Lihat juga

Berlaku untuk

CreateFileForUserAsync(User, String, CreationCollisionOption)

Edit

Membuat file baru di folder Unduhan Pengguna tertentu, dan menentukan apa yang harus dilakukan jika file dengan nama yang sama sudah ada di folder Unduhan.

public:
 static IAsyncOperation<StorageFile ^> ^ CreateFileForUserAsync(User ^ user, Platform::String ^ desiredName, CreationCollisionOption option);
/// [Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<StorageFile> CreateFileForUserAsync(User const& user, winrt::hstring const& desiredName, CreationCollisionOption const& option);
[Windows.Foundation.Metadata.Overload("CreateFileForUserWithCollisionOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<StorageFile> CreateFileForUserAsync(User user, string desiredName, CreationCollisionOption option);
function createFileForUserAsync(user, desiredName, option)
Public Shared Function CreateFileForUserAsync (user As User, desiredName As String, option As CreationCollisionOption) As IAsyncOperation(Of StorageFile)

Parameter

user
User

Pengguna tempat file dibuat.

desiredName
String

Platform::String

winrt::hstring

Nama file yang diinginkan untuk dibuat.

Jika ada file yang ada di folder saat ini yang sudah memiliki desiredName yang ditentukan, CreationCollisionOption yang ditentukan menentukan bagaimana Windows merespons konflik.

option
CreationCollisionOption

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

Karena aplikasi hanya dapat mengakses file di folder Unduhan Pengguna yang ditentukan, Anda tidak dapat menentukan OpenIfExists atau ReplaceExisting untuk parameter ini.

Mengembalikan

IAsyncOperation<StorageFile>

Ketika metode ini selesai, ia mengembalikan file baru sebagai objek StorageFile .

Atribut
OverloadAttribute RemoteAsyncAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10586.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v2.0)

Lihat juga

Berlaku untuk