FileAttributes 枚举

定义

命名空间:

System.IO

程序集:

System.Runtime.dll

提供文件和目录的属性。

此枚举支持其成员值的按位组合。

public enum class FileAttributes

[System.Flags]
public enum FileAttributes

[<System.Flags>]
type FileAttributes = 

Public Enum FileAttributes

继承

Object

ValueType

Enum

FileAttributes

属性

FlagsAttribute

字段

Archive	32	此文件标记为包含在增量备份操作中。 每当修改文件时，Windows 会设置该属性，并且在增量备份期间处理文件时，备份软件应进行清理该属性。
Compressed	2048	此文件是压缩文件。
Device	64	留待将来使用。
Directory	16	此文件是一个目录。 Directory 在 Windows、Linux 和 macOS 上受支持。
Encrypted	16384	此文件或目录已加密。 对于文件来说，表示文件中的所有数据都是加密的。 对于目录来说，表示新创建的文件和目录在默认情况下是加密的。
Hidden	2	文件是隐藏的，因此没有包括在普通的目录列表中。 Hidden 在 Windows、Linux 和 macOS 上受支持。
IntegrityStream	32768	文件或目录包括完整性支持数据。 在此值适用于文件时，文件中的所有数据流具有完整性支持。 此值将应用于一个目录时，所有新文件和子目录在该目录中和默认情况下应包括完整性支持。
None	0
Normal	128	该文件是没有特殊属性的标准文件。 仅当其单独使用时，此特性才有效。 Normal 在 Windows、Linux 和 macOS 上受支持。
NoScrubData	131072	文件或目录从完整性扫描数据中排除。 此值将应用于一个目录时，所有新文件和子目录在该目录中和默认情况下应不包括数据完整性。
NotContentIndexed	8192	将不会通过操作系统的内容索引服务来索引此文件。
Offline	4096	此文件处于脱机状态， 文件数据不能立即供使用。
ReadOnly	1	文件为只读文件。 ReadOnly 在 Windows、Linux 和 macOS 上受支持。 在 Linux 和 macOS 上，更改 ReadOnly 标记是权限操作。
ReparsePoint	1024	文件包含一个重新分析点，它是一个与文件或目录关联的用户定义的数据块。 ReparsePoint 在 Windows、Linux 和 macOS 上受支持。
SparseFile	512	此文件是稀疏文件。 稀疏文件一般是数据通常为零的大文件。
System	4	此文件是系统文件。 即，该文件是操作系统的一部分或者由操作系统以独占方式使用。
Temporary	256	文件是临时文件。 临时文件包含当执行应用程序时需要的，但当应用程序完成后不需要的数据。 文件系统尝试将所有数据保存在内存中，而不是将数据刷新回大容量存储，以便可以快速访问。 当临时文件不再需要时，应用程序应立即删除它。

示例

以下示例演示如何检索文件的属性，并在文件为只读时检查。

using System;
using System.IO;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            FileAttributes attributes = File.GetAttributes("c:/Temp/testfile.txt");
            if ((attributes & FileAttributes.ReadOnly) == FileAttributes.ReadOnly)
            {
                Console.WriteLine("read-only file");
            }
            else
            {
                Console.WriteLine("not read-only file");
            }
        }
    }
}

open System.IO

let attributes = File.GetAttributes "c:/Temp/testfile.txt"
if attributes &&& FileAttributes.ReadOnly = FileAttributes.ReadOnly then
    printfn "read-only file"
else
    printfn "not read-only file"

Imports System.IO
Imports System.Text

Module Module1
    Sub Main()
        Dim attributes = File.GetAttributes("c:/Temp/testfile.txt")
        If ((attributes And FileAttributes.ReadOnly) = FileAttributes.ReadOnly) Then
            Console.WriteLine("read-only file")
        Else
            Console.WriteLine("not read-only file")
        End If
    End Sub
End Module

注解

可以通过调用 File.GetAttributes 方法获取文件和目录的属性，也可以通过调用 File.SetAttributes 方法来设置它们。

无法使用 方法更改 对象的File.SetAttributes压缩状态File。 相反，实际上必须使用压缩工具或命名空间中的一个类来 System.IO.Compression 压缩文件。

Linux 和 macOS 上的 .NET Core 不支持以下属性：

• FileAttributes.Archive
• FileAttributes.Compressed
• FileAttributes.Device
• FileAttributes.Encrypted
• FileAttributes.IntegrityStream
• FileAttributes.NoScrubData
• FileAttributes.NotContentIndexed
• FileAttributes.Offline
• FileAttributes.SparseFile
• FileAttributes.System
• FileAttributes.Temporary

在 Unix 系统上，返回 File.GetAttributes 的值包括 Hidden 文件名以句点 (“开头的文件。) 。 在 macOS 上，可以获取或设置隐藏标志。

另请参阅

• GetAttributes(String)
• SetAttributes(String, FileAttributes)