信息
您所需的主题如下所示。但此主题未包含在此库中。
此主题尚未评级 - 评价此主题

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)

 

 

本文是否对您有所帮助?
(1500 个剩余字符)
感谢您的反馈
显示:
© 2014 Microsoft. 版权所有。