Udostępnij za pośrednictwem


File.Create Metoda

Definicja

Tworzy lub obcina i zastępuje plik w określonej ścieżce.

Przeciążenia

Create(String)

Tworzy lub obcina i zastępuje plik w określonej ścieżce.

Create(String, Int32)

Tworzy lub obcina i zastępuje plik w określonej ścieżce, określając rozmiar buforu.

Create(String, Int32, FileOptions)

Tworzy lub zastępuje plik w określonej ścieżce, określając rozmiar buforu i opcje opisujące sposób tworzenia lub zastępowania pliku.

Create(String, Int32, FileOptions, FileSecurity)

Tworzy lub zastępuje plik w określonej ścieżce, określając rozmiar buforu, opcje opisujące sposób tworzenia lub zastępowania pliku oraz wartość określającą zabezpieczenia kontroli dostępu i inspekcji dla pliku.

Create(String)

Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Tworzy lub obcina i zastępuje plik w określonej ścieżce.

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

Ścieżka i nazwa pliku do utworzenia.

Zwraca

Element FileStream , który zapewnia dostęp do odczytu/zapisu do pliku określonego w pliku path.

Wyjątki

Obiekt wywołujący nie posiada wymaganych uprawnień.

-lub-

path określony plik, który jest tylko do odczytu.

-lub-

path określono plik, który jest ukryty.

.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko biały znak lub zawiera co najmniej jeden nieprawidłowy znak. Zapytania dotyczące nieprawidłowych znaków można wykonać przy użyciu GetInvalidPathChars() metody .

path to null.

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

Wystąpił błąd we/wy podczas tworzenia pliku.

path jest w nieprawidłowym formacie.

Przykłady

Poniższy przykład tworzy plik w określonej ścieżce, zapisuje pewne informacje w pliku i odczytuje go z pliku.

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

Uwagi

Obiekt FileStream utworzony przez tę metodę ma wartość Nonedomyślną FileShare ; żaden inny proces lub kod nie może uzyskać dostępu do utworzonego pliku do momentu zamknięcia oryginalnego dojścia pliku.

Ta metoda jest równoważna Create(String, Int32) przeciążeniu metody przy użyciu domyślnego rozmiaru buforu 4096 bajtów.

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względne w stosunku do bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

Jeśli określony plik nie istnieje, zostanie utworzony; jeśli istnieje i nie jest tylko do odczytu, zawartość jest usuwana i zastępowana.

Domyślnie dla wszystkich użytkowników jest udzielany pełny dostęp do odczytu/zapisu do nowych plików. Plik jest otwierany z dostępem do odczytu/zapisu i musi zostać zamknięty przed otwarciem go przez inną aplikację.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

Create(String, Int32)

Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Tworzy lub obcina i zastępuje plik w określonej ścieżce, określając rozmiar buforu.

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

Ścieżka i nazwa pliku do utworzenia.

bufferSize
Int32

Liczba bajtów buforowanych dla odczytów i zapisów w pliku.

Zwraca

Element FileStream o określonym rozmiarze buforu, który zapewnia dostęp do odczytu/zapisu do pliku określonego w pliku path.

Wyjątki

Obiekt wywołujący nie posiada wymaganych uprawnień.

-lub-

path określony plik, który jest tylko do odczytu.

-lub-

path określono plik, który jest ukryty.

.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko biały znak lub zawiera co najmniej jeden nieprawidłowy znak. Zapytania dotyczące nieprawidłowych znaków można wykonać przy użyciu GetInvalidPathChars() metody .

path to null.

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

Wystąpił błąd we/wy podczas tworzenia pliku.

path jest w nieprawidłowym formacie.

Przykłady

Poniższy przykład tworzy plik o określonym rozmiarze buforu.

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

Uwagi

Obiekt FileStream utworzony przez tę metodę ma wartość Nonedomyślną FileShare ; żaden inny proces lub kod nie może uzyskać dostępu do utworzonego pliku do momentu zamknięcia oryginalnego dojścia pliku.

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względne w stosunku do bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

Ta metoda jest równoważna przeciążeniu konstruktora FileStream(String, FileMode, FileAccess, FileShare, Int32) . Jeśli określony plik nie istnieje, zostanie utworzony; jeśli istnieje i nie jest tylko do odczytu, zawartość zostanie zamieniona.

Domyślnie dla wszystkich użytkowników jest udzielany pełny dostęp do odczytu/zapisu do nowych plików. Plik jest otwierany z dostępem do odczytu/zapisu i musi zostać zamknięty przed otwarciem go przez inną aplikację.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

Create(String, Int32, FileOptions)

Źródło:
File.cs
Źródło:
File.cs
Źródło:
File.cs

Tworzy lub zastępuje plik w określonej ścieżce, określając rozmiar buforu i opcje opisujące sposób tworzenia lub zastępowania pliku.

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

Ścieżka i nazwa pliku do utworzenia.

bufferSize
Int32

Liczba bajtów buforowanych dla odczytów i zapisów w pliku.

options
FileOptions

FileOptions Jedna z wartości opisujących sposób tworzenia lub zastępowania pliku.

Zwraca

Nowy plik o określonym rozmiarze buforu.

Wyjątki

Obiekt wywołujący nie posiada wymaganych uprawnień.

-lub-

path określony plik, który jest tylko do odczytu.

-lub-

path określono plik, który jest ukryty.

.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko biały znak lub zawiera co najmniej jeden nieprawidłowy znak. Zapytania dotyczące nieprawidłowych znaków można wykonać przy użyciu GetInvalidPathChars() metody .

path to null.

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku.

Wystąpił błąd we/wy podczas tworzenia pliku.

path jest w nieprawidłowym formacie.

Uwagi

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względne w stosunku do bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

Ta metoda jest równoważna przeciążeniu konstruktora FileStream(String, FileMode, FileAccess, FileShare, Int32) . Jeśli określony plik nie istnieje, zostanie utworzony; jeśli istnieje i nie jest tylko do odczytu, zawartość zostanie zamieniona.

Domyślnie dla wszystkich użytkowników jest udzielany pełny dostęp do odczytu/zapisu do nowych plików. Plik jest otwierany z dostępem do odczytu/zapisu i musi zostać zamknięty przed otwarciem go przez inną aplikację.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Dotyczy

Create(String, Int32, FileOptions, FileSecurity)

Tworzy lub zastępuje plik w określonej ścieżce, określając rozmiar buforu, opcje opisujące sposób tworzenia lub zastępowania pliku oraz wartość określającą zabezpieczenia kontroli dostępu i inspekcji dla pliku.

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

Ścieżka i nazwa pliku do utworzenia.

bufferSize
Int32

Liczba bajtów buforowanych dla operacji odczytu i zapisu w pliku.

options
FileOptions

Jedną z wartości opisujących FileOptions sposób tworzenia lub zastępowania pliku.

fileSecurity
FileSecurity

FileSecurity Obiekt, który określa zabezpieczenia kontroli dostępu i inspekcji dla pliku.

Zwraca

Nowy plik o określonym rozmiarze buforu, opcjach plików i zabezpieczeniach plików.

Wyjątki

Obiekt wywołujący nie posiada wymaganych uprawnień.

-lub-

path określony plik, który jest tylko do odczytu.

-lub-

path określono plik, który jest ukryty.

.NET Framework i .NET Core w wersjach starszych niż 2.1: path jest ciągiem o zerowej długości, zawiera tylko biały odstęp lub zawiera co najmniej jeden nieprawidłowy znak. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars() metody .

path to null.

Podana ścieżka, nazwa pliku lub obie przekraczają maksymalną długość zdefiniowaną przez system.

Określona ścieżka jest nieprawidłowa (na przykład znajduje się na niezamapowanym dysku).

Wystąpił błąd we/wy podczas tworzenia pliku.

path jest w nieprawidłowym formacie.

Uwagi

Parametr path może określać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względne w stosunku do bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

Ta metoda jest odpowiednikiem przeciążenia konstruktora FileStream(String, FileMode, FileAccess, FileShare, Int32) . Jeśli określony plik nie istnieje, zostanie utworzony; jeśli istnieje i nie jest tylko do odczytu, zawartość zostanie zamieniona.

Domyślnie pełny dostęp do odczytu/zapisu do nowych plików jest przyznawany wszystkim użytkownikom. Plik jest otwierany z dostępem do odczytu/zapisu i musi zostać zamknięty przed otwarciem przez inną aplikację.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Ważne

Ta metoda została przekierowana do platformy .NET Core 3.1 w następującym formularzu: Create(FileInfo, FileMode, FileSystemRights, FileShare, Int32, FileOptions, FileSecurity).

Dotyczy