Click or drag to resize
GDStorageFolderCreateFileAsync Method (String)
Creates a new file with the specified name in the current folder.

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

Parameters

desiredName
Type: SystemString
The name of the new file to create in the current folder.

Return Value

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

Implements

IGDStorageFolderCreateFileAsync(String)
Exceptions
ExceptionCondition
ExceptionA file with the specified desiredName already exists in the current folder or some unexpected error occurred.
AccessDeniedExceptionSecure storage was remotely wiped.
InvalidArgumentExceptionThe format of the filename is incorrect. Check the value of desiredName.
Remarks

This method uses the FailIfExists value from the CreationCollisionOption enumeration by default. That is, this method raises an exception if a file with the same name already exists in the current folder. If you want to handle a file name collision in a different way, call the CreateFileAsync(String, CreationCollisionOption) method.

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) 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.
Copy
using GD;

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