File.SetAttributes 方法

  • 参考

定义

命名空间:
System.IO
程序集:
System.Runtime.dll
程序集:
mscorlib.dll, System.IO.FileSystem.dll
程序集:
System.IO.FileSystem.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll

重载

SetAttributes(SafeFileHandle, FileAttributes)

设置与 fileHandle关联的文件或目录的指定 FileAttributes 。
SetAttributes(String, FileAttributes)

获取指定路径上的文件的指定 FileAttributes。

SetAttributes(SafeFileHandle, FileAttributes)

Source:
File.cs
Source:
File.cs
Source:
File.cs

设置与 fileHandle关联的文件或目录的指定 FileAttributes 。

public:
 static void SetAttributes(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle, System::IO::FileAttributes fileAttributes);
public static void SetAttributes (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle, System.IO.FileAttributes fileAttributes);
static member SetAttributes : Microsoft.Win32.SafeHandles.SafeFileHandle * System.IO.FileAttributes -> unit
Public Shared Sub SetAttributes (fileHandle As SafeFileHandle, fileAttributes As FileAttributes)

参数

fileHandle
SafeFileHandle

应 SafeFileHandle 为其设置的文件或目录的 fileAttributes 。

fileAttributes
FileAttributes

枚举值的按位组合。

例外

ArgumentNullException

fileHandle 为 null。

UnauthorizedAccessException

调用方没有所要求的权限。

注解

无法使用 方法更改对象的SetAttributes(SafeFileHandle, FileAttributes)压缩状态File。

适用于

SetAttributes(String, FileAttributes)

Source:
File.cs
Source:
File.cs
Source:
File.cs

获取指定路径上的文件的指定 FileAttributes。

public:
 static void SetAttributes(System::String ^ path, System::IO::FileAttributes fileAttributes);
public static void SetAttributes (string path, System.IO.FileAttributes fileAttributes);
static member SetAttributes : string * System.IO.FileAttributes -> unit
Public Shared Sub SetAttributes (path As String, fileAttributes As FileAttributes)

参数

path
String

文件的路径。

fileAttributes
FileAttributes

枚举值的按位组合。

例外

ArgumentException

.NET Framework和 .NET Core 版本早于 2.1：path为空、仅包含空格、包含无效字符或文件属性无效。

PathTooLongException

指定的路径和/或文件名超过了系统定义的最大长度。

NotSupportedException

path 的格式无效。

DirectoryNotFoundException

指定的路径无效（例如，它位于未映射的驱动器上）。

FileNotFoundException

找不到该文件。

UnauthorizedAccessException

path 指定了一个只读文件。

- 或 -

当前平台不支持此操作。

- 或 -

path 指定了一个目录。

- 或 -

调用方没有所要求的权限。

示例

以下示例通过将 和 SetAttributes 属性应用于Archive文件来演示 GetAttributes 和 Hidden 方法。

using namespace System;
using namespace System::IO;
using namespace System::Text;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file if it does not exist.
   if (  !File::Exists( path ) )
   {
      File::Create( path );
   }

   if ( (File::GetAttributes( path ) & FileAttributes::Hidden) == FileAttributes::Hidden )
   {
      
      // Show the file.
      File::SetAttributes(path, File::GetAttributes( path ) & ~FileAttributes::Hidden);
      Console::WriteLine( "The {0} file is no longer hidden.", path );
   }
   else
   {
      
      // Hide the file.
      File::SetAttributes( path, static_cast<FileAttributes>(File::GetAttributes( path ) | FileAttributes::Hidden) );
      Console::WriteLine( "The {0} file is now hidden.", path );
   }
}

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Create the file if it does not exist.
        if (!File.Exists(path))
        {
            File.Create(path);
        }

        FileAttributes attributes = File.GetAttributes(path);

        if ((attributes & FileAttributes.Hidden) == FileAttributes.Hidden)
        {
            // Show the file.
            attributes = RemoveAttribute(attributes, FileAttributes.Hidden);
            File.SetAttributes(path, attributes);
            Console.WriteLine("The {0} file is no longer hidden.", path);
        }
        else
        {
            // Hide the file.
            File.SetAttributes(path, File.GetAttributes(path) | FileAttributes.Hidden);
            Console.WriteLine("The {0} file is now hidden.", path);
        }
    }

    private static FileAttributes RemoveAttribute(FileAttributes attributes, FileAttributes attributesToRemove)
    {
        return attributes & ~attributesToRemove;
    }
}

open System.IO
open System.Text

let removeAttribute attributes attributesToRemove = attributes &&& ~~~attributesToRemove

let path = @"c:\temp\MyTest.txt"

// Create the file if it does not exist.
if File.Exists path |> not then
    File.Create path |> ignore

let attributes = File.GetAttributes path

if attributes &&& FileAttributes.Hidden = FileAttributes.Hidden then
    // Show the file.
    let attributes =
        removeAttribute attributes FileAttributes.Hidden

    File.SetAttributes(path, attributes)
    printfn $"The {path} file is no longer hidden."
else
    // Hide the file.
    File.SetAttributes(path, File.GetAttributes path ||| FileAttributes.Hidden)
    printfn $"The {path} file is now hidden."

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        ' Create the file if it does not exist.
        If File.Exists(path) = False Then
            File.Create(path)
        End If

        Dim attributes As FileAttributes
        attributes = File.GetAttributes(path)

        If (attributes And FileAttributes.Hidden) = FileAttributes.Hidden Then
            ' Show the file.
            attributes = RemoveAttribute(attributes, FileAttributes.Hidden)
            File.SetAttributes(path, attributes)
            Console.WriteLine("The {0} file is no longer hidden.", path)
        Else
            ' Hide the file.
            File.SetAttributes(path, File.GetAttributes(path) Or FileAttributes.Hidden)
            Console.WriteLine("The {0} file is now hidden.", path)
        End If
    End Sub

    Public Shared Function RemoveAttribute(ByVal attributes As FileAttributes, ByVal attributesToRemove As FileAttributes) As FileAttributes
        Return attributes And (Not attributesToRemove)
    End Function
End Class

注解

允许 path 参数指定相对或绝对路径信息。 相对路径信息解释为相对于当前工作目录。 若要获取当前工作目录，请参阅 GetCurrentDirectory。

某些文件属性（如 Hidden 和 ReadOnly）可以组合使用。 其他属性（如 Normal）必须单独使用。

无法使用 方法更改对象的SetAttributes压缩状态File。

有关常见 I/O 任务的列表，请参阅 常见 I/O 任务。

另请参阅

适用于