File.Create Metoda

Definice

Obor názvů:

System.IO

Sestavení:

netstandard.dll, System.Runtime.dll

Vytvoří nebo zkrátí a přepíše soubor v zadané cestě.

Přetížení

Name	Description
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.

Create(String)

Zdroj:

File.cs

Vytvoří nebo zkrátí a přepíše soubor v zadané cestě.

public:
 static System::IO::FileStream ^ Create(System::String ^ path);

public static System.IO.FileStream Create(string path);

static member Create : string -> System.IO.FileStream

Public Shared Function Create (path As String) As FileStream

Parametry

path

String

Cesta a název souboru, který chcete vytvořit.

Návraty

FileStream

A FileStream , který poskytuje přístup pro čtení a zápis k souboru zadanému v path.

Výjimky

UnauthorizedAccessException

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

nebo

path zadal soubor, který je jen pro čtení.

nebo

path zadal soubor, který je skrytý.

ArgumentException

Verze .NET Framework a .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars() .

ArgumentNullException

path je null.

PathTooLongException

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

DirectoryNotFoundException

Zadaná cesta je neplatná (například je na nemapované jednotce).

IOException

Při vytváření souboru došlo k chybě vstupně-výstupních operací.

NotSupportedException

path je v neplatném formátu.

Příklady

Následující příklad vytvoří soubor v zadané cestě, zapíše do souboru některé informace a přečte ze souboru.

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        try
        {
            // Create the file, or overwrite if the file exists.
            using (FileStream fs = File.Create(path))
            {
                byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
                // Add some information to the file.
                fs.Write(info, 0, info.Length);
            }

            // Open the stream and read it back.
            using (StreamReader sr = File.OpenText(path))
            {
                string s = "";
                while ((s = sr.ReadLine()) != null)
                {
                    Console.WriteLine(s);
                }
            }
        }

        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

open System.IO
open System.Text

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

// Create the file, or overwrite if the file exists.
do
    use fs = File.Create path

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

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

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

Poznámky

Objekt FileStream vytvořený touto metodou má výchozí FileShare hodnotu None; žádný jiný proces nebo kód nemohou přistupovat k vytvořenému souboru, dokud nebude uzavřen původní popisovač souboru.

Tato metoda je ekvivalentní Create(String, Int32) přetížení metody s použitím výchozí velikosti vyrovnávací paměti 4 096 bajtů.

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.

Pokud zadaný soubor neexistuje, vytvoří se; pokud existuje a není jen pro čtení, obsah se odstraní a přepíše.

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. Soubor je otevřen s přístupem pro čtení a zápis a musí být zavřený, aby ho mohl otevřít jiná aplikace.

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
• Postupy: Čtení a zápis do nově vytvořeného datového souboru

Create(String, Int32)

Zdroj:

File.cs

Vytvoří nebo zkrátí a přepíše soubor v zadané cestě a určí velikost vyrovnávací paměti.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize);

public static System.IO.FileStream Create(string path, int bufferSize);

static member Create : string * int -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer) As FileStream

Parametry

path

String

Cesta a název souboru, který chcete vytvořit.

bufferSize

Int32

Počet bajtů v vyrovnávací paměti pro čtení a zápisy do souboru.

Návraty

FileStream

A FileStream se zadanou velikostí vyrovnávací paměti, která poskytuje přístup pro čtení a zápis k souboru zadanému v path.

Výjimky

UnauthorizedAccessException

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

nebo

path zadal soubor, který je jen pro čtení.

nebo

path zadal soubor, který je skrytý.

ArgumentException

Verze .NET Framework a .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars() .

ArgumentNullException

path je null.

PathTooLongException

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

DirectoryNotFoundException

Zadaná cesta je neplatná (například je na nemapované jednotce).

IOException

Při vytváření souboru došlo k chybě vstupně-výstupních operací.

NotSupportedException

path je v neplatném formátu.

Příklady

Následující příklad vytvoří soubor se zadanou velikostí vyrovnávací paměti.

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // Create the file, or overwrite if the file exists.
        using (FileStream fs = File.Create(path, 1024))
        {
            byte[] info = new UTF8Encoding(true).GetBytes("This is some text in the file.");
            // Add some information to the file.
            fs.Write(info, 0, info.Length);
        }

        // Open the stream and read it back.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

open System.IO
open System.Text

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

// Create the file, or overwrite if the file exists.
do
    use fs = File.Create(path, 1024)

    let info =
        UTF8Encoding(true)
            .GetBytes "This is some text in the file."
    // Add some information to the file.
    fs.Write(info, 0, info.Length)

// Open the stream and read it back.
do
    use sr = File.OpenText path
    let mutable s = sr.ReadLine()

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

Imports System.IO
Imports System.Text

Public Class Test
  Public Shared Sub Main()
    Dim path As String = "c:\temp\MyTest.txt"

    Try
      ' Create the file, or overwrite if the file exists.
      Using fs As FileStream = File.Create(path, 1024)
        Dim info As Byte() = New UTF8Encoding(True).GetBytes("This is some text in the file.")

        ' Add some information to the file.
        fs.Write(info, 0, info.Length)
      End Using

      ' Open the stream and read it back. 
      Using sr As StreamReader = File.OpenText(path)
        Do While sr.Peek() >= 0
          Console.WriteLine(sr.ReadLine())
        Loop
      End Using

    Catch ex As Exception
      Console.WriteLine(ex.ToString())
    End Try

  End Sub
End Class

Poznámky

Objekt FileStream vytvořený touto metodou má výchozí FileShare hodnotu None; žádný jiný proces nebo kód nemohou přistupovat k vytvořenému souboru, dokud nebude uzavřen původní popisovač souboru.

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.

Tato metoda je ekvivalentní přetížení konstruktoru FileStream(String, FileMode, FileAccess, FileShare, Int32) . Pokud zadaný soubor neexistuje, vytvoří se; pokud existuje a není jen pro čtení, obsah se nahradí.

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. Soubor je otevřen s přístupem pro čtení a zápis a musí být zavřený, aby ho mohl otevřít jiná aplikace.

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
• Postupy: Čtení a zápis do nově vytvořeného datového souboru

Create(String, Int32, FileOptions)

Zdroj:

File.cs

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.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options);

public static System.IO.FileStream Create(string path, int bufferSize, System.IO.FileOptions options);

static member Create : string * int * System.IO.FileOptions -> System.IO.FileStream

Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions) As FileStream

Parametry

path

String

Cesta a název souboru, který chcete vytvořit.

bufferSize

Int32

Počet bajtů v vyrovnávací paměti pro čtení a zápisy do souboru.

options

FileOptions

Jedna z FileOptions hodnot, které popisují, jak vytvořit nebo přepsat soubor.

Návraty

FileStream

Nový soubor se zadanou velikostí vyrovnávací paměti.

Výjimky

UnauthorizedAccessException

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

nebo

path zadal soubor, který je jen pro čtení.

nebo

path zadal soubor, který je skrytý.

ArgumentException

Verze .NET Framework a .NET Core starší než 2.1: path je řetězec nulové délky, obsahuje pouze prázdné znaky nebo obsahuje jeden nebo více neplatných znaků. Pomocí metody můžete zadat dotaz na neplatné znaky GetInvalidPathChars() .

ArgumentNullException

path je null.

PathTooLongException

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

DirectoryNotFoundException

Zadaná cesta je neplatná (například je na nemapované jednotce.

IOException

Při vytváření souboru došlo k chybě vstupně-výstupních operací.

NotSupportedException

path je v neplatném formátu.

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.

Tato metoda je ekvivalentní přetížení konstruktoru FileStream(String, FileMode, FileAccess, FileShare, Int32) . Pokud zadaný soubor neexistuje, vytvoří se; pokud existuje a není jen pro čtení, obsah se nahradí.

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. Soubor je otevřen s přístupem pro čtení a zápis a musí být zavřený, aby ho mohl otevřít jiná aplikace.

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