Skip to main content
FolderInformation.CreateFileAsync(String, CreationCollisionOption) | createFileAsync(String, CreationCollisionOption) method

Creates a new file in the current folder, and specifies what to do if a file with the same name already exists in the current folder.

Syntax


folderInformation.createFileAsync(desiredName, options).done( /* Your success and error handlers */ );

public IAsyncOperation<StorageFile> CreateFileAsync(
  string desiredName, 
  CreationCollisionOption options
)

Public Function CreateFileAsync(
  desiredName As String,  
  options As CreationCollisionOption 
) As IAsyncOperation(Of StorageFile)

public:
IAsyncOperation<StorageFile>^ CreateFileAsync(
  String^ desiredName, 
  CreationCollisionOption options
)

Parameters

desiredName

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

The name of the new file.

options

Type: CreationCollisionOption

A value that indicates what to do if the file name already exists in the current folder.

Return value

Type: IAsyncOperation<StorageFile>

When this method completes successfully, it returns a StorageFile that represents the new file.

Requirements (Windows 10 device family)

Device family

Universal, introduced version 10.0.10240.0

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

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

Metadata

Windows.Foundation.UniversalApiContract.winmd

Requirements (Windows 8.x and Windows Phone 8.x)

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

None supported

Namespace

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

Metadata

Windows.winmd

See also

FolderInformation
CreateFileAsync(String)