Click or drag to resize
GDStorageFolderCreateFileAsync Method (String, CreationCollisionOption)
Creates a new file in the current folder. This method also specifies what to do if a file with the same name already exists in the current folder.

Namespace:  GD
Assembly:  GD (in GD.dll) Version: 255.255.255.255
Syntax
Copy
public IAsyncOperation<GDStorageFile> CreateFileAsync(
	string desiredName,
	CreationCollisionOption options
)

Parameters

desiredName
Type: SystemString
The name of the new file to create in the current folder.
options
Type: Windows.StorageCreationCollisionOption
One of the enumeration values that determines how to handle the collision if a file with the specified desiredName already exists in the current folder.

Return Value

Type: IAsyncOperationGDStorageFile
When this method completes, it returns a GDStorageFile that represents the new file.

Implements

IGDStorageFolderCreateFileAsync(String, CreationCollisionOption)
Exceptions
ExceptionCondition
ExceptionYou specified FailIfExists and a file with the specified desiredName already exists in the current folder or some unexpected error occurred.
AccessDeniedExceptionSecure storage was remotely wiped or options was specified as OpenIfExists or ReplaceExisting and folder with same name as desiredName already exists.
InvalidArgumentExceptionThe format of the filename is incorrect. Check the value of desiredName or unsupported value of options was given.
Remarks

If a file with the specified desiredName already exists in the current folder, the specified CreationCollisionOption determines how to handle the collision.

If you try to create a file in a folder that represents a container for a group of files (for example, the return value from some overloads of the GetFoldersAsync method), the CreateFileAsync(String, CreationCollisionOption) method may fail.

Note: No leading nor trailing spaces are stripped from desiredName.

Examples
The following example shows how to create a new file in a SDK secure folder. This example explicitly specifies a value for options that causes the operation to fail if a file with the specified desiredName already exists in the current folder.
Copy
using GD;

var secureFile = await GDWindows.Instance.SecureFolder.CreateFileAsync("sample.txt", CreationCollisionOption.FailIfExists);
See Also