File.Create Metoda

Definice

Obor názvů:

System.IO

Sestavení:

System.Runtime.dll

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

Přetížení

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 soubor vytvořit nebo přepsat.

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(a) soubor, který je jen pro čtení.

-nebo-

path zadal(a) soubor, který je skrytý.

ArgumentException

.NET Framework a .NET Core verze 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ů. Na neplatné znaky se můžete dotazovat pomocí metody .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 nenamapované jednotce).

IOException

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

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 čte ze souboru.

using namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

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

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 nemůže získat přístup k vytvořenému souboru, dokud původní popisovač souboru není uzavřen.

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

Parametr path může zadat relativní nebo absolutní informace o cestě. Informace o relativní cestě jsou vykládány jako relativní k aktuálnímu pracovnímu adresáři. Pokud chcete získat aktuální pracovní adresář, přečtěte si téma GetCurrentDirectory.

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

Ve výchozím nastavení je všem uživatelům udělen úplný přístup pro čtení a zápis k novým souborům. Soubor je otevřen s přístupem pro čtení i zápis a musí být zavřený, aby ho bylo možné otevřít jinou aplikací.

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

Viz také

• Vstupně-výstupní operace 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(a) soubor, který je jen pro čtení.

-nebo-

path zadal(a) soubor, který je skrytý.

ArgumentException

.NET Framework a .NET Core verze 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ů. Na neplatné znaky se můžete dotazovat pomocí metody .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 nenamapované jednotce).

IOException

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

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 namespace System;
using namespace System::IO;
using namespace System::Text;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   
   // Create the file, or overwrite if the file exists.
   FileStream^ fs = File::Create( path, 1024 );
   try
   {
      array<Byte>^info = (gcnew UTF8Encoding( true ))->GetBytes( "This is some text in the file." );
      
      // Add some information to the file.
      fs->Write( info, 0, info->Length );
   }
   finally
   {
      if ( fs )
            delete (IDisposable^)fs;
   }

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

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 nemůže získat přístup k vytvořenému souboru, dokud původní popisovač souboru není uzavřen.

Parametr path může zadat relativní nebo absolutní informace o cestě. Informace o relativní cestě jsou vykládány jako relativní k aktuálnímu pracovnímu adresáři. Pokud chcete získat aktuální pracovní adresář, přečtěte si téma GetCurrentDirectory.

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

Ve výchozím nastavení je všem uživatelům udělen úplný přístup pro čtení a zápis k novým souborům. Soubor je otevřen s přístupem pro čtení i zápis a musí být zavřený, aby ho bylo možné otevřít jinou aplikací.

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

Viz také

• Vstupně-výstupní operace 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 soubor vytvořit nebo přepsat.

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á popisuje, 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(a) soubor, který je jen pro čtení.

-nebo-

path zadal(a) soubor, který je skrytý.

ArgumentException

.NET Framework a .NET Core verze 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ů. Na neplatné znaky se můžete dotazovat pomocí metody .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 nenamapované jednotce).

IOException

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

NotSupportedException

path je v neplatném formátu.

Poznámky

Parametr path může zadat relativní nebo absolutní informace o cestě. Informace o relativní cestě jsou vykládány jako relativní k aktuálnímu pracovnímu adresáři. Pokud chcete získat aktuální pracovní adresář, přečtěte si téma GetCurrentDirectory.

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

Ve výchozím nastavení je všem uživatelům udělen úplný přístup pro čtení a zápis k novým souborům. Soubor je otevřen s přístupem pro čtení i zápis a musí být zavřený, aby ho bylo možné otevřít jinou aplikací.

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