CreationCollisionOption Enumeration

Referenz

Definition

Namespace:: Windows.Storage

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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).txt`die 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.

Gilt für:

Freigeben über