File.GetAttributes Metódus

Definíció

Névtér:

System.IO

Szerelvények:

netstandard.dll, System.Runtime.dll

Túlterhelések

Name	Description
GetAttributes(SafeFileHandle)	Lekéri a megadott FileAttributes fájlt vagy könyvtárat fileHandle.
GetAttributes(String)	Lekéri a FileAttributes fájl elérési útját.

GetAttributes(SafeFileHandle)

Forrás:

File.cs

Lekéri a megadott FileAttributes fájlt vagy könyvtárat fileHandle.

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

Paraméterek

fileHandle

SafeFileHandle

A SafeFileHandle fájlra vagy könyvtárra, amelyhez az attribútumokat le kell kérni.

Válaszok

FileAttributes

A FileAttributes fájl vagy könyvtár.

Kivételek

ArgumentNullException

fileHandle az null.

UnauthorizedAccessException

A hívó nem rendelkezik a szükséges engedéllyel.

GetAttributes(String)

Forrás:

File.cs

Lekéri a FileAttributes fájl elérési útját.

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

Paraméterek

path

String

A fájl elérési útja.

Válaszok

FileAttributes

Az FileAttributes elérési úton lévő fájl.

Kivételek

ArgumentException

.NET Framework és .NET Core 2.1-nél régebbi verziói: path üres, csak üres szóközöket tartalmaz, vagy érvénytelen karaktereket tartalmaz.

PathTooLongException

A megadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

path formátuma érvénytelen.

FileNotFoundException

path egy fájlt jelöl, és érvénytelen, például leképezetlen meghajtón van, vagy a fájl nem található.

DirectoryNotFoundException

path egy könyvtárat jelöl, és érvénytelen, például nem leképezett meghajtón van, vagy a könyvtár nem található.

IOException

Ezt a fájlt egy másik folyamat használja.

UnauthorizedAccessException

A hívó nem rendelkezik a szükséges engedéllyel.

Példák

Az alábbi példa a fájlra alkalmazott attribútumokkal mutatja GetAttributes be a SetAttributes metódusokat és Archive a Hidden metódusokat.

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

Megjegyzések

A path paraméter relatív vagy abszolút elérésiút-információkat adhat meg. A relatív elérési út adatai az aktuális munkakönyvtárhoz viszonyítva értelmezve lesznek. Az aktuális munkakönyvtár beszerzéséhez lásd: GetCurrentDirectory.

A gyakori I/O-feladatok listáját a Gyakori I/O-feladatok című témakörben találja.

Lásd még

• Fájl és folyam I/O
• Szöveg olvasása fájlból
• Útmutató: Szöveg írása fájlba