File.GetAttributes Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Přetížení

Name	Description
GetAttributes(SafeFileHandle)	Získá zadaný FileAttributes soubor nebo adresář přidružený fileHandle.
GetAttributes(String)	FileAttributes Získá soubor na cestě.

GetAttributes(SafeFileHandle)

Zdroj:

File.cs

Získá zadaný FileAttributes soubor nebo adresář přidružený 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

Parametry

fileHandle

SafeFileHandle

Do SafeFileHandle souboru nebo adresáře, pro který se mají načíst atributy.

Návraty

FileAttributes

Soubor FileAttributes nebo adresář.

Výjimky

ArgumentNullException

fileHandle je null.

UnauthorizedAccessException

Volající nemá požadované oprávnění.

GetAttributes(String)

Zdroj:

File.cs

FileAttributes Získá soubor na cestě.

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

Parametry

path

String

Cesta k souboru.

Návraty

FileAttributes

Soubor FileAttributes v cestě.

Výjimky

ArgumentException

.NET Framework a verze .NET Core starší než 2.1: path je prázdný, obsahuje pouze prázdné znaky nebo obsahuje neplatné znaky.

PathTooLongException

Zadaná cesta, název souboru nebo obojí překračují maximální délku definovanou systémem.

NotSupportedException

path je v neplatném formátu.

FileNotFoundException

path představuje soubor a je neplatný, například že je na nemapované jednotce nebo soubor nelze najít.

DirectoryNotFoundException

path představuje adresář a je neplatný, například že je na nemapované jednotce nebo adresář nebyl nalezen.

IOException

Tento soubor používá jiný proces.

UnauthorizedAccessException

Volající nemá požadované oprávnění.

Příklady

Následující příklad ukazuje GetAttributes a SetAttributes metody použitím Archive a Hidden atributů na soubor.

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

Poznámky

Parametr path má povoleno zadat relativní nebo absolutní informace o cestě. Relativní informace o cestě se interpretují jako relativní vzhledem k aktuálnímu pracovnímu adresáři. Aktuální pracovní adresář získáte v tématu GetCurrentDirectory.

Seznam běžných vstupně-výstupních úloh najdete v tématu Běžné vstupně-výstupní úlohy.

Viz také

• Vstup/výstup souborů a streamů
• Čtení textu ze souboru
• Postupy: Zápis textu do souboru