Share via

NameCollisionOption Enum

  • Reference

Definition

Namespace:
Windows.Storage
Edit

Specifies what to do if a file or folder with the specified name already exists in the current folder when you copy, move, or rename a file or folder.

public enum class NameCollisionOption
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class NameCollisionOption
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum NameCollisionOption
var value = Windows.Storage.NameCollisionOption.generateUniqueName
Public Enum NameCollisionOption
Inheritance
Enum
NameCollisionOption
Attributes
ContractVersionAttribute

Windows requirements

Device family
Windows 10 (introduced in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v1.0)

Fields

Name Value Description
GenerateUniqueName 0

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).
ReplaceExisting 1

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

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

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

Applies to