File.GetAttributes 方法

定義

命名空間:

System.IO

組件:

System.Runtime.dll

多載

GetAttributes(SafeFileHandle)	取得與相關聯的fileHandle檔案或目錄的指定FileAttributes。
GetAttributes(String)	取得路徑上檔案的 FileAttributes。

GetAttributes(SafeFileHandle)

來源:

File.cs

取得與相關聯的fileHandle檔案或目錄的指定FileAttributes。

public:
 static System::IO::FileAttributes GetAttributes(Microsoft::Win32::SafeHandles::SafeFileHandle ^ fileHandle);

public static System.IO.FileAttributes GetAttributes (Microsoft.Win32.SafeHandles.SafeFileHandle fileHandle);

static member GetAttributes : Microsoft.Win32.SafeHandles.SafeFileHandle -> System.IO.FileAttributes

Public Shared Function GetAttributes (fileHandle As SafeFileHandle) As FileAttributes

參數

fileHandle

SafeFileHandle

要 SafeFileHandle 擷取屬性之檔案或目錄的 。

傳回

FileAttributes

FileAttributes檔案或目錄的 。

例外狀況

ArgumentNullException

fileHandle 為 null。

UnauthorizedAccessException

呼叫端沒有必要的權限。

GetAttributes(String)

來源:

File.cs

取得路徑上檔案的 FileAttributes。

public:
 static System::IO::FileAttributes GetAttributes(System::String ^ path);

public static System.IO.FileAttributes GetAttributes (string path);

static member GetAttributes : string -> System.IO.FileAttributes

Public Shared Function GetAttributes (path As String) As FileAttributes

參數

path

String

檔案的路徑。

傳回

FileAttributes

路徑上檔案的 FileAttributes。

例外狀況

ArgumentException

.NET Framework 和 2.1 之前的 .NET Core 版本：path是空的、只包含空格符，或包含無效的字元。

PathTooLongException

指定的路徑、檔案名稱，或兩者都超出系統定義的長度上限。

NotSupportedException

path 格式無效。

FileNotFoundException

path 代表檔案無效，例如位在未對應的磁碟機上，或找不到檔案。

DirectoryNotFoundException

path 代表目錄無效，例如位在未對應的磁碟機上，或找不到目錄。

IOException

其他處理序正在使用此檔案。

UnauthorizedAccessException

呼叫端沒有必要的權限。

範例

下列範例示範 GetAttributes 和 SetAttributes 方法，方法是將 和 Hidden 屬性套用Archive至檔案。

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。

如需一般 I/O 工作的清單，請參閱 一般 I/O 工作。

另請參閱

• 檔案和資料流 I/O
• 從檔案讀取文字
• 作法：將文字寫入檔案