CreationCollisionOption Énumération

Référence

Définition

Espace de noms:: Windows.Storage

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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.

S’applique à

Partager via