CreationCollisionOption CreationCollisionOption CreationCollisionOption CreationCollisionOption Enum

Specifies what to do if a file or folder with the specified name already exists in the current folder when you create a new file or folder.

Syntax

Declaration

public enum CreationCollisionOptionpublic enum CreationCollisionOptionPublic Enum CreationCollisionOption

Remarks

Methods that don't explicitly pass a value from the CreationCollisionOption enumeration use the FailIfExists value as the default when you create a file or folder.

For example, the CreateFileAsync(System.String,Windows.Storage.CreationCollisionOption) method has one overload, CreateFileAsync(System.String,Windows.Storage.CreationCollisionOption), that explicitly passes a value from the CreationCollisionOption enumeration. If you call the other overload, CreateFileAsync(System.String), the method uses the FailIfExists option as the default.

Fields

FailIfExists
FailIfExists
FailIfExists
FailIfExists

Raise an exception of type System.Exception if the file or folder already exists.

Methods that don't explicitly pass a value from the CreationCollisionOption enumeration use the FailIfExists value as the default when you try to create, rename, copy, or move a file or folder.

GenerateUniqueName
GenerateUniqueName
GenerateUniqueName
GenerateUniqueName

Automatically append a number to the base of the specified name if the file or folder already exists.

For example, if MyFile.txt already exists, then the new file is named MyFile (2).txt. If MyFolder already exists, then the new folder is named MyFolder (2).

OpenIfExists
OpenIfExists
OpenIfExists
OpenIfExists

Return the existing item if the file or folder already exists.

ReplaceExisting
ReplaceExisting
ReplaceExisting
ReplaceExisting

Replace the existing item if the file or folder already exists.

Device family

Windows 10 (introduced v10.0.10240.0)

API contract

Windows.Foundation.UniversalApiContract (introduced v1)

Attributes

Windows.Foundation.Metadata.ContractVersionAttribute

Details

Assembly

Windows.Storage.dll