CreationCollisionOption Enumerazione

Definizione

Spazio dei nomi:

Windows.Storage

Specifica cosa fare se esiste già un file o una cartella con il nome specificato nella cartella corrente quando si crea un nuovo file o una nuova cartella.

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

Ereditarietà

Enum

CreationCollisionOption

Attributi

ContractVersionAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Campi

Nome	Valore	Descrizione
FailIfExists	2	Generare un'eccezione di tipo System.Exception se il file o la cartella esiste già. I metodi che non passano esplicitamente un valore dall'enumerazione CreationCollisionOption usano il valore FailIfExists come impostazione predefinita quando si tenta di creare, rinominare, copiare o spostare un file o una cartella.
GenerateUniqueName	0	Aggiungere automaticamente un numero alla base del nome specificato se il file o la cartella esiste già. Ad esempio, se MyFile.txt esiste già, il nuovo file è denominato MyFile (2).txt. Se MyFolder esiste già, la nuova cartella è denominata MyFolder (2).
OpenIfExists	3	Restituisce l'elemento esistente se il file o la cartella esiste già.
ReplaceExisting	1	Sostituire l'elemento esistente se il file o la cartella esiste già.

Commenti

I metodi che non passano in modo esplicito un valore dall'enumerazione CreationCollisionOption usano il valore FailIfExists come impostazione predefinita quando si crea un file o una cartella.

Ad esempio, il metodo CreateFileAsync ha un overload, CreateFileAsync (String, . CreationCollisionOption) che passa in modo esplicito un valore dall'enumerazione CreationCollisionOption. Se si chiama l'altro overload, CreateFileAsync (String), il metodo usa l'opzione FailIfExists come impostazione predefinita.