DownloadsFolder.CreateFileForUserAsync 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
| 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)
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
- 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
Ketika metode ini selesai, ia mengembalikan file baru sebagai objek StorageFile .
- Atribut
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)
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
- 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
Ketika metode ini selesai, ia mengembalikan file baru sebagai objek StorageFile .
- Atribut
Persyaratan Windows
| Rangkaian perangkat |
Windows 10 (diperkenalkan dalam 10.0.10586.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v2.0)
|