CreationCollisionOption 列舉

定義

命名空間:

Windows.Storage

指定當您建立新檔案或資料夾時，如果具有指定名稱的檔案或資料夾已存在於目前資料夾中，該怎麼辦。

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

繼承

Enum

CreationCollisionOption

屬性

ContractVersionAttribute

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， 。CreationCollisionOption) ，其會從 CreationCollisionOption 列舉明確傳遞值。 如果您呼叫其他多載， CreateFileAsync (String) ，此方法會使用 FailIfExists 選項作為預設值。