CreationCollisionOption Enumeração
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
| Nome | Valor | Description |
|---|---|---|
| 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 |
| 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.