本頁是否能提供幫助?
您對此內容的意見反應十分重要。 請告訴我們您的想法。
其他意見反應?
剩餘 1500 個字元
MSDN Library
資訊
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

StorageFolder.CreateFileAsync(String, CreationCollisionOption) | createFileAsync(String, CreationCollisionOption) Method

在目前資料夾中建立新的檔案,並指定如果具有相同名稱的檔案已經存在於目前的資料夾時所要執行的動作。

語法


storageFolder.createFileAsync(desiredName, options).done( /* 您的成功與錯誤處理常式 */ );

參數

desiredName

類型: String [JavaScript] | System.String [.NET] | Platform::String [C++]

要建立的檔案所需的名稱。

如果在已經有指定之 desiredName 的目前資料夾中有現有的檔案,指定的 CreationCollisionOption 就會決定 Windows 如何回應衝突。

options

類型: CreationCollisionOption

判斷當 desiredName 與目前資料夾中的現有檔案名稱相同時 Windows 應如何回應的列舉值。

傳回值

類型: IAsyncOperation<StorageFile>

當這個方法完成時,它會傳回新的檔案做為 StorageFile

備註

如果您嘗試在虛擬資料夾 (例如媒體櫃或檔案群組) 中建立檔案,這個方法可能會失敗。

範例

檔案存取範例示範如何使用 createFileAsync(String, CreationCollisionOption) 方法在文件庫中建立新的檔案,如下所示:


Windows.Storage.KnownFolders.documentsLibrary.createFileAsync("sample.txt",
    Windows.Storage.CreationCollisionOption.replaceExisting).then(function (file) {
        sampleFile = file;
    });

如範例所示,您可以使用 thendone,宣告擷取和處理新檔案的函式。在 createFileAsync(String, CreationCollisionOption) 方法完成之後,新的檔案會傳遞至您的處理函式做為 StorageFile 物件 (範例中的file )。

附註  若要建立文件庫中的檔案,您必須在應用程式資訊清單中宣告必要功能。如需進一步了解功能,請參閱使用 Windows 執行階段存取使用者資源

需求

最低支援的用戶端

Windows 8

最低支援的伺服器

Windows Server 2012

最低支援的電話

Windows Phone 8

命名空間

Windows.Storage
Windows::Storage [C++]

中繼資料

Windows.winmd

另請參閱

StorageFolder
CreateFileAsync(String)

 

 

Microsoft 正展開一份線上問卷調查,了解您對於 MSDN 網站的看法。 如果您選擇參加,您離開 MSDN 網站時即會顯示線上問卷調查。

您是否想要參加?
顯示:
© 2015 Microsoft