CreationCollisionOption Énumération

Définition

Espace de noms:

Windows.Storage

Spécifie ce qu’il faut faire si un fichier ou un dossier portant le nom spécifié existe déjà dans le dossier actif lorsque vous créez un fichier ou un dossier.

public enum class CreationCollisionOption

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class CreationCollisionOption

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum CreationCollisionOption

var value = Windows.Storage.CreationCollisionOption.generateUniqueName

Public Enum CreationCollisionOption

Héritage

Enum

CreationCollisionOption

Attributs

ContractVersionAttribute

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Champs

FailIfExists	2	Déclenchez une exception de type System.Exception si le fichier ou le dossier existe déjà. Les méthodes qui ne passent pas explicitement une valeur à partir de l’énumération CreationCollisionOption utilisent la valeur FailIfExists comme valeur par défaut lorsque vous essayez de créer, renommer, copier ou déplacer un fichier ou un dossier.
GenerateUniqueName	0	Ajoutez automatiquement un nombre à la base du nom spécifié si le fichier ou le dossier existe déjà. Par exemple, si MyFile.txt existe déjà, le nouveau fichier est nommé MyFile (2).txt. S’il MyFolder existe déjà, le nouveau dossier est nommé MyFolder (2).
OpenIfExists	3	Retourne l’élément existant si le fichier ou le dossier existe déjà.
ReplaceExisting	1	Remplacez l’élément existant si le fichier ou le dossier existe déjà.

Remarques

Les méthodes qui ne passent pas explicitement une valeur à partir de l’énumération CreationCollisionOption utilisent la valeur FailIfExists comme valeur par défaut lorsque vous créez un fichier ou un dossier.

Par exemple, la méthode CreateFileAsync a une surcharge, CreateFileAsync (String, . CreationCollisionOption) qui transmet explicitement une valeur de l’énumération CreationCollisionOption. Si vous appelez l’autre surcharge, CreateFileAsync (String), la méthode utilise l’option FailIfExists comme valeur par défaut.