FileInfo Třída

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

FileInfo.cs

Poskytuje vlastnosti a metody instancí pro vytváření, kopírování, odstraňování, přesouvání a otevírání souborů a pomůcky při vytváření FileStream objektů. Tuto třídu nelze zdědit.

public ref class FileInfo sealed : System::IO::FileSystemInfo

public sealed class FileInfo : System.IO.FileSystemInfo

type FileInfo = class
    inherit FileSystemInfo

Public NotInheritable Class FileInfo
Inherits FileSystemInfo

Dědičnost

Object

MarshalByRefObject

FileSystemInfo

FileInfo

Příklady

Následující příklad ukazuje některé hlavní členy FileInfo třídy.

Při prvním načtení FileInfo vlastností volá metodu Refresh a ukládá informace o souboru do mezipaměti. Při dalších voláních musíte zavolat Refresh , abyste získali nejnovější kopii informací.

using System;
using System.IO;

class Test
{
    
    public static void Main()
    {
        string path = Path.GetTempFileName();
        var fi1 = new FileInfo(path);

        // Create a file to write to.
        using (StreamWriter sw = fi1.CreateText())
        {
            sw.WriteLine("Hello");
            sw.WriteLine("And");
            sw.WriteLine("Welcome");
        }	

        // Open the file to read from.
        using (StreamReader sr = fi1.OpenText())
        {
            var s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }

        try
        {
            string path2 = Path.GetTempFileName();
            var fi2 = new FileInfo(path2);

            // Ensure that the target does not exist.
            fi2.Delete();

            // Copy the file.
            fi1.CopyTo(path2);
            Console.WriteLine($"{path} was copied to {path2}.");

            // Delete the newly created file.
            fi2.Delete();
            Console.WriteLine($"{path2} was successfully deleted.");
        }
        catch (Exception e)
        {
            Console.WriteLine($"The process failed: {e.ToString()}");
        }
    }
}

Imports System.IO

Public Class Test

    Public Shared Sub Main()
        Dim path1 As String = Path.GetTempFileName()
        Dim path2 As String = Path.GetTempFileName()
        Dim fi As New FileInfo(path1)

        ' Create a file to write to.
        Using sw As StreamWriter = fi.CreateText()
            sw.WriteLine("Hello")
            sw.WriteLine("And")
            sw.WriteLine("Welcome")
        End Using

        Try
            ' Open the file to read from.
            Using sr As StreamReader = fi.OpenText()
                Do While sr.Peek() >= 0
                    Console.WriteLine(sr.ReadLine())
                Loop
            End Using

            Dim fi2 As New FileInfo(path2)

            ' Ensure that the target does not exist.
            fi2.Delete()

            ' Copy the file.
            fi.CopyTo(path2)
            Console.WriteLine($"{path1} was copied to {path2}.")

            ' Delete the newly created file.
            fi2.Delete()
            Console.WriteLine($"{path2} was successfully deleted.")

        Catch e As Exception
            Console.WriteLine($"The process failed: {e.ToString()}.")
        End Try
    End Sub
End Class

Tento příklad vytvoří výstup podobný následujícímu.

Hello
And
Welcome
C:\Users\userName\AppData\Local\Temp\tmp70AB.tmp was copied to C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp.
C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp was successfully deleted.

Poznámky

FileInfo Třída se používá pro typické operace, jako je kopírování, přesouvání, přejmenování, vytváření, otevírání, odstraňování a připojování k souborům.

Pokud provádíte více operací se stejným souborem, může být efektivnější používat FileInfo metody instance místo odpovídajících statických File metod třídy, protože kontrola zabezpečení nebude vždy nutná.

Mnoho metod FileInfo vrací při vytváření nebo otevírání souborů jiné vstupně-výstupní typy. Tyto další typy můžete použít k další manipulaci se souborem. Další informace naleznete v konkrétních FileInfo členech, například Open, OpenReadOpenText, , CreateTextnebo Create.

Ve výchozím nastavení je úplný přístup pro čtení a zápis k novým souborům udělen všem uživatelům.

Následující tabulka popisuje výčty, které se používají k přizpůsobení chování různých FileInfo metod.

Výčet	Popis
FileAccess	Určuje přístup pro čtení a zápis k souboru.
FileShare	Určuje úroveň přístupu povolenou pro soubor, který se již používá.
FileMode	Určuje, zda je obsah existujícího souboru zachován nebo přepsán a zda požadavky na vytvoření existujícího souboru způsobí výjimku.

Poznámka

U členů, kteří přijímají cestu jako vstupní řetězec, musí být tato cesta správně vytvořená nebo je vyvolána výjimka. Pokud je například cesta plně kvalifikovaná, ale začíná mezerou, cesta není oříznuta metodami třídy. Proto je cesta poškozena a je vyvolána výjimka. Podobně cesta nebo kombinace cest nemůže být plně kvalifikovaná dvakrát. Například "c:\temp c:\windows" vyvolá ve většině případů výjimku. Při použití metod, které přijímají řetězec cesty, se ujistěte, že jsou cesty správně vytvořené.

Ve členech, kteří přijímají cestu, může cesta odkazovat na soubor nebo pouze adresář. Zadaná cesta může také odkazovat na relativní cestu nebo cestu UNC (Universal Naming Convention) pro název serveru a sdílené složky. Například všechny následující cesty jsou přijatelné:

• "c:\\MyDir\\MyFile.txt" v jazyce C# nebo "c:\MyDir\MyFile.txt" v jazyce Visual Basic.

• "c:\\MyDir" v jazyce C# nebo "c:\MyDir" v jazyce Visual Basic.

• "MyDir\\MySubdir" v jazyce C# nebo "MyDir\MySubDir" v jazyce Visual Basic.

• "\\\\MyServer\\MyShare" v jazyce C# nebo "\\MyServer\MyShare" v jazyce Visual Basic.

Třída FileInfo poskytuje následující vlastnosti, které umožňují načíst informace o souboru. Příklad použití jednotlivých vlastností najdete na stránkách vlastností.

• Vlastnost Directory načte objekt, který představuje nadřazený adresář souboru.

• Vlastnost DirectoryName načte úplnou cestu nadřazeného adresáře souboru.

• Vlastnost Exists zkontroluje přítomnost souboru před jeho provozem.

• Vlastnost IsReadOnly načte nebo nastaví hodnotu, která určuje, zda lze soubor upravit.

• Načte Length velikost souboru.

• Načte Name název souboru.

Konstruktory

Name	Description
FileInfo(String)	Inicializuje novou instanci FileInfo třídy, která funguje jako obálka pro cestu k souboru.

Pole

Name	Description
FullPath	Představuje plně kvalifikovanou cestu k adresáři nebo souboru. (Zděděno od FileSystemInfo)
OriginalPath	Cesta původně určená uživatelem, ať už relativní, nebo absolutní. (Zděděno od FileSystemInfo)

Vlastnosti

Name	Description
Attributes	Získá nebo nastaví atributy pro aktuální soubor nebo adresář. (Zděděno od FileSystemInfo)
CreationTime	Získá nebo nastaví čas vytvoření aktuálního souboru nebo adresáře. (Zděděno od FileSystemInfo)
CreationTimeUtc	Získá nebo nastaví čas vytvoření v koordinovaném univerzálním čase (UTC) aktuálního souboru nebo adresáře. (Zděděno od FileSystemInfo)
Directory	Získá instanci nadřazeného adresáře.
DirectoryName	Získá řetězec představující úplnou cestu k adresáři.
Exists	Získá hodnotu označující, zda soubor existuje.
Extension	Získá příponu části názvu souboru, včetně úvodní tečky . , i když se jedná o celý název souboru, nebo prázdný řetězec, pokud není k dispozici žádná přípona. (Zděděno od FileSystemInfo)
FullName	Získá úplnou cestu k adresáři nebo souboru. (Zděděno od FileSystemInfo)
IsReadOnly	Získá nebo nastaví hodnotu, která určuje, zda je aktuální soubor jen pro čtení.
LastAccessTime	Získá nebo nastaví čas posledního přístupu k aktuálnímu souboru nebo adresáři. (Zděděno od FileSystemInfo)
LastAccessTimeUtc	Získá nebo nastaví čas v koordinovaném univerzálním čase (UTC), ke kterému byl naposledy přístupný aktuální soubor nebo adresář. (Zděděno od FileSystemInfo)
LastWriteTime	Získá nebo nastaví čas, kdy byl aktuální soubor nebo adresář naposledy zapsán. (Zděděno od FileSystemInfo)
LastWriteTimeUtc	Získá nebo nastaví čas v koordinovaném univerzálním čase (UTC), kdy byl aktuální soubor nebo adresář naposledy zapsán. (Zděděno od FileSystemInfo)
Length	Získá velikost aktuálního souboru v bajtech.
LinkTarget	Získá cílovou cestu odkazu umístěného v FullName, nebo null pokud tato FileSystemInfo instance nepředstavuje odkaz. (Zděděno od FileSystemInfo)
Name	Získá název souboru.
UnixFileMode	Získá nebo nastaví unixový režim souboru pro aktuální soubor nebo adresář. (Zděděno od FileSystemInfo)

Metody

Name	Description
AppendText()	Vytvoří, StreamWriter který připojí text k souboru reprezentované touto instancí objektu FileInfo.
CopyTo(String, Boolean)	Zkopíruje existující soubor do nového souboru, což umožňuje přepsání existujícího souboru.
CopyTo(String)	Zkopíruje existující soubor do nového souboru a zakáže přepsání existujícího souboru.
Create()	Vytvoří soubor.
CreateAsSymbolicLink(String)	Vytvoří symbolický odkaz, který odkazuje FullName na zadaný pathToTarget. (Zděděno od FileSystemInfo)
CreateText()	Vytvoří soubor StreamWriter , který zapíše nový textový soubor.
Decrypt()	Dešifruje soubor, který byl zašifrován aktuálním účtem pomocí Encrypt() metody.
Delete()	Trvale odstraní soubor.
Encrypt()	Zašifruje soubor tak, aby ho dešifrovat mohl jenom účet použitý k šifrování souboru.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. SerializationInfo Nastaví objekt s názvem souboru a dalšími informacemi o výjimce. (Zděděno od FileSystemInfo)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
MoveTo(String, Boolean)	Přesune zadaný soubor do nového umístění a poskytne možnosti pro zadání nového názvu souboru a přepsání cílového souboru, pokud již existuje.
MoveTo(String)	Přesune zadaný soubor do nového umístění a poskytne možnost zadat nový název souboru.
Open(FileMode, FileAccess, FileShare)	Otevře soubor v zadaném režimu s přístupem ke čtení, zápisu nebo čtení/zápisu a zadanou možností sdílení.
Open(FileMode, FileAccess)	Otevře soubor v zadaném režimu s přístupem ke čtení, zápisu nebo čtení/zápisu.
Open(FileMode)	Otevře soubor v zadaném režimu.
Open(FileStreamOptions)	Inicializuje novou instanci FileStream třídy se zadaným režimem vytvoření, oprávněním ke čtení a zápisu a sdílení, přístup k ostatním FileStreams může mít stejný soubor, velikost vyrovnávací paměti, další možnosti souboru a velikost přidělení.
OpenRead()	Vytvoří jen FileStreampro čtení .
OpenText()	StreamReader Vytvoří kódování UTF8, které čte z existujícího textového souboru.
OpenWrite()	Vytvoří pouze FileStreamzápis .
Refresh()	Aktualizuje stav objektu. (Zděděno od FileSystemInfo)
Replace(String, String, Boolean)	Nahradí obsah zadaného souboru souborem popsaným aktuálním FileInfo objektem, odstraněním původního souboru a vytvořením zálohy nahrazeného souboru. Určuje také, jestli se mají ignorovat chyby sloučení.
Replace(String, String)	Nahradí obsah zadaného souboru souborem popsaným aktuálním FileInfo objektem, odstraní původní soubor a vytvoří zálohu nahrazeného souboru.
ResolveLinkTarget(Boolean)	Získá cíl zadaného propojení. (Zděděno od FileSystemInfo)
ToString()	Vrátí původní cestu. FullName Name Pro úplnou cestu nebo název souboru nebo adresáře použijte vlastnosti. (Zděděno od FileSystemInfo)

Metody rozšíření

Name	Description
Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity)	Vytvoří nový datový proud souborů a zajistí, že se vytvoří se zadanými vlastnostmi a nastavením zabezpečení.
GetAccessControl(FileInfo, AccessControlSections)	Vrátí informace o zabezpečení souboru.
GetAccessControl(FileInfo)	Vrátí informace o zabezpečení souboru.
SetAccessControl(FileInfo, FileSecurity)	Změní atributy zabezpečení existujícího souboru.

Viz také

• FileSystemWatcher
• DriveInfo
• Vstup/výstup souborů a streamů
• Postupy: Čtení textu ze souboru
• Postupy: Zápis textu do souboru
• Postupy: Čtení a zápis do nově vytvořeného datového souboru