CreationCollisionOption
CreationCollisionOption
CreationCollisionOption
CreationCollisionOption
Enum
Definition
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.
public : enum class CreationCollisionOptionpublic enum CreationCollisionOptionPublic Enum CreationCollisionOption// You can use this enum in JavaScript.
- Attributes
| Device family |
Windows 10 (introduced v10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced v1)
|
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 |
| 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. |
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 method has one overload, CreateFileAsync (String, .CreationCollisionOption), that explicitly passes a value from the CreationCollisionOption enumeration. If you call the other overload, CreateFileAsync (String), the method uses the FailIfExists option as the default.