CreationCollisionOption 列挙型

定義

新しいファイルまたはフォルダーを作成するときに、指定した名前のファイルまたはフォルダーが現在のフォルダーに既に存在する場合の対処方法を指定します。

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
継承
CreationCollisionOption
属性

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

フィールド

FailIfExists 2

ファイルまたはフォルダーが既に存在する場合は、 System.Exception 型の例外を発生させます。

CreationCollisionOption 列挙から値を明示的に渡さないメソッドでは、ファイルまたはフォルダーを作成、名前変更、コピー、または移動しようとすると、 FailIfExists 値が既定値として使用されます。

GenerateUniqueName 0

ファイルまたはフォルダーが既に存在する場合は、指定した名前のベースに数値を自動的に追加します。

たとえば、既に存在する場合 MyFile.txt 、新しいファイルの名前 MyFile (2).txtは です。 既に存在する場合 MyFolder 、新しいフォルダーの名前 MyFolder (2)は です。

OpenIfExists 3

ファイルまたはフォルダーが既に存在する場合は、既存の項目を返します。

ReplaceExisting 1

ファイルまたはフォルダーが既に存在する場合は、既存の項目を置き換えます。

注釈

CreationCollisionOption 列挙から値を明示的に渡さないメソッドでは、ファイルまたはフォルダーを作成するときに、 FailIfExists 値が既定値として使用されます。

たとえば、 CreateFileAsync メソッドには、 CreateFileAsync (String, ) という 1 つのオーバーロードがあります。CreationCollisionOption) 。 CreationCollisionOption 列挙体から値を明示的に渡します。 もう 1 つのオーバーロード である CreateFileAsync (String) を呼び出すと、メソッドは FailIfExists オプションを既定値として使用します。

適用対象