CreationCollisionOption Enumeration

Definition

Namespace:

Windows.Storage

Gibt an, was zu tun ist, wenn eine Datei oder ein Ordner mit dem angegebenen Namen bereits im aktuellen Ordner vorhanden ist, wenn Sie eine neue Datei oder einen neuen Ordner erstellen.

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

Vererbung

Enum

CreationCollisionOption

Attribute

ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Felder

FailIfExists	2	Lösen Sie eine Ausnahme vom Typ System.Exception aus , wenn die Datei oder der Ordner bereits vorhanden ist. Methoden, die einen Wert aus der CreationCollisionOption-Enumeration nicht explizit übergeben, verwenden den FailIfExists-Wert als Standard, wenn Sie versuchen, eine Datei oder einen Ordner zu erstellen, umzubenennen, zu kopieren oder zu verschieben.
GenerateUniqueName	0	Fügen Sie automatisch eine Zahl an die Basis des angegebenen Namens an, wenn die Datei oder der Ordner bereits vorhanden ist. Wenn MyFile.txt z. B. bereits vorhanden ist, heißt MyFile (2).txtdie neue Datei . Wenn MyFolder bereits vorhanden ist, heißt MyFolder (2)der neue Ordner .
OpenIfExists	3	Gibt das vorhandene Element zurück, wenn die Datei oder der Ordner bereits vorhanden ist.
ReplaceExisting	1	Ersetzen Sie das vorhandene Element, wenn die Datei oder der Ordner bereits vorhanden ist.

Hinweise

Methoden, die einen Wert nicht explizit aus der CreationCollisionOption-Enumeration übergeben, verwenden den FailIfExists-Wert als Standard, wenn Sie eine Datei oder einen Ordner erstellen.

Die CreateFileAsync-Methode verfügt beispielsweise über eine Überladung: CreateFileAsync (String, . CreationCollisionOption), das explizit einen Wert aus der CreationCollisionOption-Enumeration übergibt. Wenn Sie die andere Überladung CreateFileAsync (String) aufrufen, verwendet die Methode die FailIfExists-Option als Standardeinstellung.