Partilhar via


CreationCollisionOption Enumeração

Definição

Especifica o que fazer se um arquivo ou pasta com o nome especificado já existir na pasta atual quando você criar um novo arquivo ou pasta.

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
Herança
CreationCollisionOption
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Campos

FailIfExists 2

Gere uma exceção do tipo System.Exception se o arquivo ou pasta já existir.

Métodos que não passam explicitamente um valor da enumeração CreationCollisionOption usam o valor FailIfExists como padrão quando você tenta criar, renomear, copiar ou mover um arquivo ou pasta.

GenerateUniqueName 0

Acrescente automaticamente um número à base do nome especificado se o arquivo ou pasta já existir.

Por exemplo, se MyFile.txt já existir, o novo arquivo será nomeado MyFile (2).txt. Se MyFolder já existir, a nova pasta será denominada MyFolder (2).

OpenIfExists 3

Retornará o item existente se o arquivo ou pasta já existir.

ReplaceExisting 1

Substitua o item existente se o arquivo ou pasta já existir.

Comentários

Métodos que não passam explicitamente um valor da enumeração CreationCollisionOption usam o valor FailIfExists como padrão ao criar um arquivo ou pasta.

Por exemplo, o método CreateFileAsync tem uma sobrecarga, CreateFileAsync (String, . CreationCollisionOption), que passa explicitamente um valor da enumeração CreationCollisionOption. Se você chamar a outra sobrecarga, CreateFileAsync (String), o método usará a opção FailIfExists como padrão.

Aplica-se a