Sdílet prostřednictvím


File.Create Metoda

Definice

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, Int32, FileOptions, FileSecurity)

Vytvoří nebo přepíše soubor v zadané cestě a určí velikost vyrovnávací paměti, možnosti, které popisují, jak soubor vytvořit nebo přepsat, a hodnotu, která určuje řízení přístupu a zabezpečení auditu souboru.

Create(String)

Zdroj:
File.cs
Zdroj:
File.cs
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

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

Výjimky

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ý.

.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()

path je null.

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

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

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

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é

Platí pro

Create(String, Int32)

Zdroj:
File.cs
Zdroj:
File.cs
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

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

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ý.

.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()

path je null.

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

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

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

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é

Platí pro

Create(String, Int32, FileOptions)

Zdroj:
File.cs
Zdroj:
File.cs
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

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

Výjimky

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ý.

.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()

path je null.

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

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

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

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.

Platí pro

Create(String, Int32, FileOptions, FileSecurity)

Vytvoří nebo přepíše soubor v zadané cestě a určí velikost vyrovnávací paměti, možnosti, které popisují, jak vytvořit nebo přepsat soubor, a hodnotu, která určuje řízení přístupu a audit zabezpečení pro soubor.

public:
 static System::IO::FileStream ^ Create(System::String ^ path, int bufferSize, System::IO::FileOptions options, System::Security::AccessControl::FileSecurity ^ fileSecurity);
public static System.IO.FileStream Create (string path, int bufferSize, System.IO.FileOptions options, System.Security.AccessControl.FileSecurity fileSecurity);
static member Create : string * int * System.IO.FileOptions * System.Security.AccessControl.FileSecurity -> System.IO.FileStream
Public Shared Function Create (path As String, bufferSize As Integer, options As FileOptions, fileSecurity As FileSecurity) As FileStream

Parametry

path
String

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

bufferSize
Int32

Počet bajtů ve 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.

fileSecurity
FileSecurity

Objekt FileSecurity , který určuje zabezpečení řízení přístupu a auditu pro soubor.

Návraty

Nový soubor se zadanou velikostí vyrovnávací paměti, možnostmi souborů a zabezpečením souborů.

Výjimky

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ý.

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 se můžete dotazovat na neplatné znaky GetInvalidPathChars() .

path je null.

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

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

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

path je v neplatném formátu.

Poznámky

Parametr path může zadat informace o relativní nebo absolutní cestě. Informace o relativní cestě jsou vykládány jako relativní k aktuálnímu pracovnímu adresáři. Informace o získání aktuálního pracovního adresáře najdete v tématu GetCurrentDirectory.

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

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í a 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.

Důležité

Tato metoda byla přenesena do .NET Core 3.1 v následující podobě: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).

Platí pro