Partager via


CreationCollisionOption Énumération

Définition

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
CreationCollisionOption
Attributs

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.

S’applique à