Share via


FileOpenDisposition Enum

Definition

Enumeration values for actions to take on a file.

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 327680)]
public enum FileOpenDisposition
Inheritance
FileOpenDisposition
Attributes

Windows requirements

Device family
Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
API contract
Windows.Foundation.UniversalApiContract (introduced in v5.0)

Fields

Name Value Description
OpenExisting 0

Opens a file only if it exists.

OpenAlways 1

Opens a file. If the file does not exist, a new file will be created and opened.

CreateNew 2

Creates a new file if one does not exist. If the file does exist, this will fail.

CreateAlways 3

Opens a file and truncates it so that its size is zero bytes. If the file does not exist, a new file will be created and opened.

TruncateExisting 4

Opens a file and truncates it so that its size is zero bytes. If the file does not exist, this will fail.

Remarks

The results of the FileOpenDisposition values depend on whether the file exists or not.

Applies to

Product Versions
WinRT Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100