共用方式為

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 選項作為預設值。

適用於