File Třída

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

Zdroj:

File.cs

Poskytuje statické metody pro vytváření, kopírování, odstraňování, přesouvání a otevírání jednoho souboru a pomáhá při vytváření FileStream objektů.

public ref class File abstract sealed

public static class File

type File = class

Public Class File

Dědičnost

Object

File

Příklady

Následující příklad ukazuje, jak pomocí třídy File zkontrolovat, zda soubor existuje, a v závislosti na výsledku buď vytvořit nový soubor a zapisovat do něj, nebo otevřít existující soubor a číst z něj. Před spuštěním kódu vytvořte složku c:\temp.

using namespace System;
using namespace System::IO;
int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   if (  !File::Exists( path ) )
   {
      
      // Create a file to write to.
      StreamWriter^ sw = File::CreateText( path );
      try
      {
         sw->WriteLine( "Hello" );
         sw->WriteLine( "And" );
         sw->WriteLine( "Welcome" );
      }
      finally
      {
         if ( sw )
                  delete (IDisposable^)(sw);
      }
   }

   // Open the file to read from.
   StreamReader^ sr = File::OpenText( path );
   try
   {
      String^ s = "";
      while ( s = sr->ReadLine() )
      {
         Console::WriteLine( s );
      }
   }
   finally
   {
      if ( sr )
            delete (IDisposable^)(sr);
   }

   try
   {
      String^ path2 = String::Concat( path, "temp" );
      
      // Ensure that the target does not exist.
      File::Delete( path2 );
      
      // Copy the file.
      File::Copy( path, path2 );
      Console::WriteLine( "{0} was copied to {1}.", path, path2 );
      
      // Delete the newly created file.
      File::Delete( path2 );
      Console::WriteLine( "{0} was successfully deleted.", path2 );
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }
}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
        }

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

open System.IO

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

if File.Exists path |> not then
    // Create a file to write to.
    use sw = File.CreateText path
    sw.WriteLine "Hello"
    sw.WriteLine "And"
    sw.WriteLine "Welcome"

// Open the file to read from.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

    while isNull s |> not do
        printfn $"{s}"
        s <- sr.ReadLine()

Imports System.IO

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        If File.Exists(path) = False Then
            ' Create a file to write to.
            Using sw As StreamWriter = File.CreateText(path)
                sw.WriteLine("Hello")
                sw.WriteLine("And")
                sw.WriteLine("Welcome")
           End Using
        End If

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

Poznámky

Třída File slouží k typickým operacím, jako je kopírování, přesouvání, přejmenování, vytváření, otevírání, odstraňování a připojování k jednomu souboru najednou. Pomocí třídy File můžete také získat a nastavit atributy souboru nebo DateTime informace související s vytvořením, přístupem a zápisem souboru. Pokud chcete provádět operace s více soubory, přečtěte si Directory.GetFiles nebo DirectoryInfo.GetFiles.

Mnoho File metod vrací jiné vstupně-výstupní typy při vytváření nebo otevírání souborů. Tyto další typy můžete použít k další manipulaci se souborem. Další informace najdete v konkrétních File členů, jako jsou OpenText, CreateTextnebo Create.

Vzhledem k tomu, že všechny File metody jsou statické, pokud chcete provést pouze jednu akci, může být efektivnější použít metodu File než odpovídající metodu instance FileInfo. Všechny File metody vyžadují cestu k souboru, se kterým pracujete.

Statické metody třídy File provádějí kontroly zabezpečení pro všechny metody. Pokud budete objekt opakovaně používat, zvažte místo toho použití odpovídající metody instance FileInfo, protože kontrola zabezpečení nebude vždy nutná.

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 metod File.

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.

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

Metody

AppendAllLines(String, IEnumerable<String>)	Připojí řádky k souboru a pak soubor zavře. Pokud zadaný soubor neexistuje, tato metoda vytvoří soubor, zapíše zadané řádky do souboru a pak soubor zavře.
AppendAllLines(String, IEnumerable<String>, Encoding)	Připojí řádky k souboru pomocí zadaného kódování a pak soubor zavře. Pokud zadaný soubor neexistuje, tato metoda vytvoří soubor, zapíše zadané řádky do souboru a pak soubor zavře.
AppendAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Asynchronně připojí řádky k souboru a pak soubor zavře. Pokud zadaný soubor neexistuje, tato metoda vytvoří soubor, zapíše zadané řádky do souboru a pak soubor zavře.
AppendAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Asynchronně připojí řádky k souboru pomocí zadaného kódování a pak soubor zavře. Pokud zadaný soubor neexistuje, tato metoda vytvoří soubor, zapíše zadané řádky do souboru a pak soubor zavře.
AppendAllText(String, String)	Otevře soubor, připojí zadaný řetězec k souboru a pak soubor zavře. Pokud soubor neexistuje, tato metoda vytvoří soubor, zapíše zadaný řetězec do souboru a pak soubor zavře.
AppendAllText(String, String, Encoding)	Připojí zadaný řetězec k souboru pomocí zadaného kódování a vytvoří soubor, pokud ještě neexistuje.
AppendAllTextAsync(String, String, CancellationToken)	Asynchronně otevře soubor nebo vytvoří soubor, pokud ještě neexistuje, připojí zadaný řetězec k souboru a pak soubor zavře.
AppendAllTextAsync(String, String, Encoding, CancellationToken)	Asynchronně otevře soubor nebo vytvoří soubor, pokud ještě neexistuje, připojí zadaný řetězec k souboru pomocí zadaného kódování a pak soubor zavře.
AppendText(String)	Vytvoří StreamWriter, který připojí kódovaný text UTF-8 k existujícímu souboru nebo k novému souboru, pokud zadaný soubor neexistuje.
Copy(String, String)	Zkopíruje existující soubor do nového souboru. Přepsání souboru se stejným názvem není povoleno.
Copy(String, String, Boolean)	Zkopíruje existující soubor do nového souboru. Přepsání souboru se stejným názvem je povoleno.
Create(String)	Vytvoří nebo zkrátí a přepíše soubor v zadané cestě.
Create(String, Int32)	Vytvoří nebo zkrátí a přepíše soubor v zadané cestě a určí velikost vyrovnávací paměti.
Create(String, Int32, FileOptions)	Vytvoří nebo přepíše soubor v zadané cestě a určí velikost vyrovnávací paměti a možnosti, které popisují, jak vytvořit nebo přepsat soubor.
CreateSymbolicLink(String, String)	Vytvoří symbolický odkaz na soubor identifikovaný path, který odkazuje na pathToTarget.
CreateText(String)	Vytvoří nebo otevře soubor pro zápis zakódovaného textu UTF-8. Pokud soubor již existuje, jeho obsah se nahradí.
Decrypt(String)	Dešifruje soubor, který byl zašifrován aktuálním účtem pomocí metody Encrypt(String).
Delete(String)	Odstraní zadaný soubor.
Encrypt(String)	Zašifruje soubor tak, aby ho dešifrovat mohl jenom účet použitý k šifrování souboru.
Exists(String)	Určuje, zda zadaný soubor existuje.
GetAttributes(SafeFileHandle)	Získá zadaný FileAttributes souboru nebo adresáře asociovaného s fileHandle.
GetAttributes(String)	Získá FileAttributes souboru na cestě.
GetCreationTime(SafeFileHandle)	Vrátí čas vytvoření zadaného souboru nebo adresáře.
GetCreationTime(String)	Vrátí datum a čas vytvoření zadaného souboru nebo adresáře.
GetCreationTimeUtc(SafeFileHandle)	Vrátí datum a čas vytvoření v koordinovaném univerzálním čase (UTC) zadaného souboru nebo adresáře.
GetCreationTimeUtc(String)	Vrátí datum a čas vytvoření v koordinovaném univerzálním čase (UTC) zadaného souboru nebo adresáře.
GetLastAccessTime(SafeFileHandle)	Vrátí datum a čas posledního přístupu zadaného souboru nebo adresáře.
GetLastAccessTime(String)	Vrátí datum a čas posledního přístupu zadaného souboru nebo adresáře.
GetLastAccessTimeUtc(SafeFileHandle)	Vrátí datum a čas posledního přístupu v koordinovaném univerzálním čase (UTC) zadaného souboru nebo adresáře.
GetLastAccessTimeUtc(String)	Vrátí datum a čas ve standardu UTC (Coordinated Universal Time), ke kterému byl zadaný soubor nebo adresář naposledy přístupný.
GetLastWriteTime(SafeFileHandle)	Vrátí datum a čas posledního zápisu zadaného souboru nebo adresáře.
GetLastWriteTime(String)	Vrátí datum a čas posledního zápisu zadaného souboru nebo adresáře.
GetLastWriteTimeUtc(SafeFileHandle)	Vrátí datum a čas posledního zápisu v koordinovaném univerzálním čase (UTC) zadaného souboru nebo adresáře.
GetLastWriteTimeUtc(String)	Vrátí datum a čas ve standardu UTC (Coordinated Universal Time), do kterého byl zadaný soubor nebo adresář naposledy zapsán.
GetUnixFileMode(SafeFileHandle)	Získá UnixFileMode zadaného popisovače souboru.
GetUnixFileMode(String)	Získá UnixFileMode souboru na cestě.
Move(String, String)	Přesune zadaný soubor do nového umístění a poskytne možnost zadat nový název souboru.
Move(String, 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 nahrazení cílového souboru, pokud již existuje.
Open(String, FileMode)	Otevře FileStream na zadané cestě s přístupem pro čtení a zápis bez sdílení.
Open(String, FileMode, FileAccess)	Otevře FileStream na zadané cestě se zadaným režimem a přístupem bez sdílení.
Open(String, FileMode, FileAccess, FileShare)	Otevře FileStream na zadané cestě, která má zadaný režim s přístupem ke čtení, zápisu nebo čtení/zápisu a zadané možnosti sdílení.
Open(String, FileStreamOptions)	Inicializuje novou instanci třídy FileStream se zadanou cestou, 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í.
OpenHandle(String, FileMode, FileAccess, FileShare, FileOptions, Int64)	Inicializuje novou instanci třídy SafeFileHandle se zadanou cestou, režimem vytvoření, oprávněním ke čtení/zápisu a sdílení, přístup k dalším souborům SafeFileHandles může mít stejný soubor, další možnosti souboru a velikost přidělení.
OpenRead(String)	Otevře existující soubor pro čtení.
OpenText(String)	Otevře existující textový soubor s kódováním UTF-8 pro čtení.
OpenWrite(String)	Otevře existující soubor nebo vytvoří nový soubor pro zápis.
ReadAllBytes(String)	Otevře binární soubor, přečte obsah souboru do pole bajtů a pak soubor zavře.
ReadAllBytesAsync(String, CancellationToken)	Asynchronně otevře binární soubor, přečte obsah souboru do bajtového pole a pak soubor zavře.
ReadAllLines(String)	Otevře textový soubor, přečte všechny řádky souboru a pak soubor zavře.
ReadAllLines(String, Encoding)	Otevře soubor, přečte všechny řádky souboru se zadaným kódováním a pak soubor zavře.
ReadAllLinesAsync(String, CancellationToken)	Asynchronně otevře textový soubor, přečte všechny řádky souboru a pak soubor zavře.
ReadAllLinesAsync(String, Encoding, CancellationToken)	Asynchronně otevře textový soubor, přečte všechny řádky souboru se zadaným kódováním a pak soubor zavře.
ReadAllText(String)	Otevře textový soubor, přečte veškerý text v souboru a pak soubor zavře.
ReadAllText(String, Encoding)	Otevře soubor, přečte veškerý text v souboru se zadaným kódováním a pak soubor zavře.
ReadAllTextAsync(String, CancellationToken)	Asynchronně otevře textový soubor, přečte veškerý text v souboru a pak soubor zavře.
ReadAllTextAsync(String, Encoding, CancellationToken)	Asynchronně otevře textový soubor, přečte veškerý text v souboru se zadaným kódováním a pak soubor zavře.
ReadLines(String)	Přečte řádky souboru.
ReadLines(String, Encoding)	Přečtěte si řádky souboru, který má zadané kódování.
ReadLinesAsync(String, CancellationToken)	Asynchronně čte řádky souboru.
ReadLinesAsync(String, Encoding, CancellationToken)	Asynchronně čte řádky souboru se zadaným kódováním.
Replace(String, String, String)	Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru.
Replace(String, String, String, Boolean)	Nahradí obsah zadaného souboru obsahem jiného souboru, odstraní původní soubor a vytvoří zálohu nahrazeného souboru a volitelně ignoruje chyby sloučení.
ResolveLinkTarget(String, Boolean)	Získá cíl zadaného odkazu na soubor.
SetAttributes(SafeFileHandle, FileAttributes)	Nastaví zadanou FileAttributes souboru nebo adresáře přidruženého k fileHandle.
SetAttributes(String, FileAttributes)	Nastaví zadanou FileAttributes souboru na zadané cestě.
SetCreationTime(SafeFileHandle, DateTime)	Nastaví datum a čas vytvoření souboru nebo adresáře.
SetCreationTime(String, DateTime)	Nastaví datum a čas vytvoření souboru.
SetCreationTimeUtc(SafeFileHandle, DateTime)	Nastaví datum a čas ve standardu UTC (Coordinated Universal Time), který byl vytvořen soubor nebo adresář.
SetCreationTimeUtc(String, DateTime)	Nastaví datum a čas v koordinovaném univerzálním čase (UTC), které byl soubor vytvořen.
SetLastAccessTime(SafeFileHandle, DateTime)	Nastaví datum a čas posledního přístupu k zadanému souboru nebo adresáři.
SetLastAccessTime(String, DateTime)	Nastaví datum a čas posledního přístupu k zadanému souboru.
SetLastAccessTimeUtc(SafeFileHandle, DateTime)	Nastaví datum a čas v koordinovaném univerzálním čase (UTC), ke kterému byl zadaný soubor nebo adresář naposledy přístupný.
SetLastAccessTimeUtc(String, DateTime)	Nastaví datum a čas v koordinovaném univerzálním čase (UTC), ke kterému byl zadaný soubor naposledy přístupný.
SetLastWriteTime(SafeFileHandle, DateTime)	Nastaví datum a čas posledního zápisu zadaného souboru nebo adresáře.
SetLastWriteTime(String, DateTime)	Nastaví datum a čas posledního zápisu zadaného souboru.
SetLastWriteTimeUtc(SafeFileHandle, DateTime)	Nastaví datum a čas v koordinovaném univerzálním čase (UTC), do kterého byl zadaný soubor nebo adresář naposledy zapsán.
SetLastWriteTimeUtc(String, DateTime)	Nastaví datum a čas v koordinovaném univerzálním čase (UTC), do kterého byl zadaný soubor naposledy zapsán.
SetUnixFileMode(SafeFileHandle, UnixFileMode)	Nastaví zadanou UnixFileMode zadaného popisovače souboru.
SetUnixFileMode(String, UnixFileMode)	Nastaví zadanou UnixFileMode souboru na zadané cestě.
WriteAllBytes(String, Byte[])	Vytvoří nový soubor, zapíše zadané pole bajtů do souboru a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše.
WriteAllBytesAsync(String, Byte[], CancellationToken)	Asynchronně vytvoří nový soubor, zapíše zadané pole bajtů do souboru a potom soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše.
WriteAllLines(String, IEnumerable<String>)	Vytvoří nový soubor, zapíše do souboru kolekci řetězců a pak soubor zavře.
WriteAllLines(String, IEnumerable<String>, Encoding)	Vytvoří nový soubor pomocí zadaného kódování, zapíše do souboru kolekci řetězců a pak soubor zavře.
WriteAllLines(String, String[])	Vytvoří nový soubor, zapíše do souboru zadané pole řetězců a pak soubor zavře.
WriteAllLines(String, String[], Encoding)	Vytvoří nový soubor, zapíše zadané pole řetězců do souboru pomocí zadaného kódování a pak soubor zavře.
WriteAllLinesAsync(String, IEnumerable<String>, CancellationToken)	Asynchronně vytvoří nový soubor, zapíše zadané řádky do souboru a pak soubor zavře.
WriteAllLinesAsync(String, IEnumerable<String>, Encoding, CancellationToken)	Asynchronně vytvoří nový soubor, zapište zadané řádky do souboru pomocí zadaného kódování a pak soubor zavřete.
WriteAllText(String, String)	Vytvoří nový soubor, zapíše zadaný řetězec do souboru a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše.
WriteAllText(String, String, Encoding)	Vytvoří nový soubor, zapíše zadaný řetězec do souboru pomocí zadaného kódování a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše.
WriteAllTextAsync(String, String, CancellationToken)	Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše.
WriteAllTextAsync(String, String, Encoding, CancellationToken)	Asynchronně vytvoří nový soubor, zapíše zadaný řetězec do souboru pomocí zadaného kódování a pak soubor zavře. Pokud cílový soubor již existuje, zkrátí se a přepíše.

Viz také

• DriveInfo
• FileSystemWatcher
• soubor a streamování vstupně-výstupních
• čtení textu ze souboru
• Postupy: Zápis textu do souboru
• Postupy: Čtení a zápis do nově vytvořeného datového souboru