File.Create Метод

Определение

Пространство имен:

System.IO

Сборки:

netstandard.dll, System.Runtime.dll

Создает или усечение и перезаписывает файл в указанном пути.

Перегрузки

Имя	Описание
Create(String)	Создает или усечение и перезаписывает файл в указанном пути.
Create(String, Int32)	Создает или усечение и перезаписывает файл в указанном пути, указывая размер буфера.
Create(String, Int32, FileOptions)	Создает или перезаписывает файл в указанном пути, указывая размер буфера и параметры, описывающие создание или перезапись файла.

Create(String)

Исходный код:

File.cs

Создает или усечение и перезаписывает файл в указанном пути.

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

Параметры

path

String

Путь и имя создаваемого файла.

Возвращаемое значение

FileStream

A FileStream , предоставляющий доступ для чтения и записи к файлу, указанному в path.

Исключения

UnauthorizedAccessException

Вызывающий объект не имеет требуемого разрешения.

–или–

path указали файл, доступный только для чтения.

–или–

path указать файл, скрытый.

ArgumentException

Версии .NET Framework и .NET Core старше 2.1: path представляет собой строку нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().

ArgumentNullException

path равно null.

PathTooLongException

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

DirectoryNotFoundException

Указанный путь недопустим (например, он находится на несопоставленном диске).

IOException

При создании файла произошла ошибка ввода-вывода.

NotSupportedException

path имеет недопустимый формат.

Примеры

В следующем примере создается файл в указанном пути, записывается некоторая информация в файл и считывается из файла.

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

Комментарии

ОбъектFileStream, созданный этим методом, имеет значение FileShareпо умолчаниюNone; ни один другой процесс или код не может получить доступ к созданному файлу, пока исходный дескриптор файла не будет закрыт.

Этот метод эквивалентен Create(String, Int32) перегрузке метода, используя размер буфера по умолчанию размером 4096 байт.

Параметр path может указывать относительные или абсолютные сведения о пути. Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу. Чтобы получить текущий рабочий каталог, см. GetCurrentDirectory.

Если указанный файл не существует, он создается; Если он существует и не доступен только для чтения, содержимое удаляется и перезаписывается.

По умолчанию всем пользователям предоставляется полный доступ на чтение и запись к новым файлам. Файл открывается с доступом на чтение и запись и должен быть закрыт, прежде чем его можно будет открыть другим приложением.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• Файловый и потоковый ввод-вывод
• чтение текста из файла
• Практическое руководство. Запись текста в файл
• Практическое руководство. Чтение и запись в только что созданный файл данных

Create(String, Int32)

Исходный код:

File.cs

Создает или усечение и перезаписывает файл в указанном пути, указывая размер буфера.

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

Параметры

path

String

Путь и имя создаваемого файла.

bufferSize

Int32

Количество байтов, буферизованное для операций чтения и записи в файл.

Возвращаемое значение

FileStream

С FileStream указанным размером буфера, предоставляющим доступ для чтения и записи к файлу, указанному в path.

Исключения

UnauthorizedAccessException

Вызывающий объект не имеет требуемого разрешения.

–или–

path указали файл, доступный только для чтения.

–или–

path указать файл, скрытый.

ArgumentException

Версии .NET Framework и .NET Core старше 2.1: path представляет собой строку нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().

ArgumentNullException

path равно null.

PathTooLongException

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

DirectoryNotFoundException

Указанный путь недопустим (например, он находится на несопоставленном диске).

IOException

При создании файла произошла ошибка ввода-вывода.

NotSupportedException

path имеет недопустимый формат.

Примеры

В следующем примере создается файл с указанным размером буфера.

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

Комментарии

ОбъектFileStream, созданный этим методом, имеет значение FileShareпо умолчаниюNone; ни один другой процесс или код не может получить доступ к созданному файлу, пока исходный дескриптор файла не будет закрыт.

Параметр path может указывать относительные или абсолютные сведения о пути. Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу. Чтобы получить текущий рабочий каталог, см. GetCurrentDirectory.

Этот метод эквивалентен перегрузке конструктора FileStream(String, FileMode, FileAccess, FileShare, Int32) . Если указанный файл не существует, он создается; Если он существует, и он не доступен только для чтения, содержимое заменяется.

По умолчанию всем пользователям предоставляется полный доступ на чтение и запись к новым файлам. Файл открывается с доступом на чтение и запись и должен быть закрыт, прежде чем его можно будет открыть другим приложением.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.

См. также раздел

• Файловый и потоковый ввод-вывод
• чтение текста из файла
• Практическое руководство. Запись текста в файл
• Практическое руководство. Чтение и запись в только что созданный файл данных

Create(String, Int32, FileOptions)

Исходный код:

File.cs

Создает или перезаписывает файл в указанном пути, указывая размер буфера и параметры, описывающие создание или перезапись файла.

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

Параметры

path

String

Путь и имя создаваемого файла.

bufferSize

Int32

Количество байтов, буферизованное для операций чтения и записи в файл.

options

FileOptions

Одно из FileOptions значений, описывающих, как создать или перезаписать файл.

Возвращаемое значение

FileStream

Новый файл с указанным размером буфера.

Исключения

UnauthorizedAccessException

Вызывающий объект не имеет требуемого разрешения.

–или–

path указали файл, доступный только для чтения.

–или–

path указать файл, скрытый.

ArgumentException

Версии .NET Framework и .NET Core старше 2.1: path представляет собой строку нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().

ArgumentNullException

path равно null.

PathTooLongException

Указанный путь, имя файла или оба превышают определенную системой максимальную длину.

DirectoryNotFoundException

Указанный путь недопустим (например, он находится на несопоставленном диске.

IOException

При создании файла произошла ошибка ввода-вывода.

NotSupportedException

path имеет недопустимый формат.

Комментарии

Параметр path может указывать относительные или абсолютные сведения о пути. Относительные сведения о пути интерпретируются как относительные к текущему рабочему каталогу. Чтобы получить текущий рабочий каталог, см. GetCurrentDirectory.

Этот метод эквивалентен перегрузке конструктора FileStream(String, FileMode, FileAccess, FileShare, Int32) . Если указанный файл не существует, он создается; Если он существует, и он не доступен только для чтения, содержимое заменяется.

По умолчанию всем пользователям предоставляется полный доступ на чтение и запись к новым файлам. Файл открывается с доступом на чтение и запись и должен быть закрыт, прежде чем его можно будет открыть другим приложением.

Список распространенных задач ввода-вывода см. в разделе Распространенные задачи ввода-вывода.