Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Класс File

 

Опубликовано: Октябрь 2016

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

Просмотреть исходный код .NET Framework для этого типа Reference Source.

Пространство имен:   System.IO
Сборка:  mscorlib (в mscorlib.dll)


[ComVisibleAttribute(true)]
public static class File

ИмяОписание
System_CAPS_pubmethodSystem_CAPS_staticAppendAllLines(String, IEnumerable<String>)

Добавляет строки в файл, затем закрывает файл. Если указанный файл не существует, этот метод создает файл, записывает в него указанные строки и затем закрывает файл.

System_CAPS_pubmethodSystem_CAPS_staticAppendAllLines(String, IEnumerable<String>, Encoding)

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

System_CAPS_pubmethodSystem_CAPS_staticAppendAllText(String, String)

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

System_CAPS_pubmethodSystem_CAPS_staticAppendAllText(String, String, Encoding)

Добавляет указанную строку в файл, создавая файл, если он не существует.

System_CAPS_pubmethodSystem_CAPS_staticAppendText(String)

Создает объект StreamWriter, добавляющий текст с кодировкой UTF-8 в существующий файл, или в новый файл, если указанный файл не существует.

System_CAPS_pubmethodSystem_CAPS_staticCopy(String, String)

Копирует существующий файл в новый файл. Перезапись файла с тем же именем не разрешена.

System_CAPS_pubmethodSystem_CAPS_staticCopy(String, String, Boolean)

Копирует существующий файл в новый файл. Перезапись файла с тем же именем разрешена.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String)

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

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32)

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

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32, FileOptions)

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

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32, FileOptions, FileSecurity)

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

System_CAPS_pubmethodSystem_CAPS_staticCreateText(String)

Создается или открывается файл для записи текста в кодировке UTF-8.

System_CAPS_pubmethodSystem_CAPS_staticDecrypt(String)

Расшифровывает файл, зашифрованный текущей учетной записью с помощью метода Encrypt.

System_CAPS_pubmethodSystem_CAPS_staticDelete(String)

Удаляет указанный файл.

System_CAPS_pubmethodSystem_CAPS_staticEncrypt(String)

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

System_CAPS_pubmethodSystem_CAPS_staticExists(String)

Определяет, существует ли заданный файл.

System_CAPS_pubmethodSystem_CAPS_staticGetAccessControl(String)

Получает объект FileSecurity, который инкапсулирует записи списка ACL для заданного файла.

System_CAPS_pubmethodSystem_CAPS_staticGetAccessControl(String, AccessControlSections)

Получает объект FileSecurity, инкапсулирующий записи списка ACL определенного типа для конкретного файла.

System_CAPS_pubmethodSystem_CAPS_staticGetAttributes(String)

Получает значение FileAttributes для файла в пути.

System_CAPS_pubmethodSystem_CAPS_staticGetCreationTime(String)

Возвращает дату и время создания заданного файла или каталога.

System_CAPS_pubmethodSystem_CAPS_staticGetCreationTimeUtc(String)

Возвращает дату и время создания заданного файла или каталога в формате общего скоординированного времени (UTC).

System_CAPS_pubmethodSystem_CAPS_staticGetLastAccessTime(String)

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

System_CAPS_pubmethodSystem_CAPS_staticGetLastAccessTimeUtc(String)

Возвращает дату и время последнего доступа к заданному файлу или каталогу в формате всемирного координированного времени (UTC).

System_CAPS_pubmethodSystem_CAPS_staticGetLastWriteTime(String)

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

System_CAPS_pubmethodSystem_CAPS_staticGetLastWriteTimeUtc(String)

Возвращает дату и время последней операции записи в заданный файл или каталог в формате всемирного координированного времени (UTC).

System_CAPS_pubmethodSystem_CAPS_staticMove(String, String)

Перемещает заданный файл в новое местоположение и разрешает переименование файла.

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode)

Открывает объект FileStream по указанному пути с доступом для чтения и записи.

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode, FileAccess)

Открывает FileStream в заданном пути с заданным режимом и доступом.

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode, FileAccess, FileShare)

Открывает FileStream в заданном пути, с заданным режимом доступа для чтения, записи или чтения и записи и с заданным параметром совместного использования.

System_CAPS_pubmethodSystem_CAPS_staticOpenRead(String)

Открывает для чтения существующий файл.

System_CAPS_pubmethodSystem_CAPS_staticOpenText(String)

Открывает для чтения существующий файл, содержащий текст в кодировке UTF-8.

System_CAPS_pubmethodSystem_CAPS_staticOpenWrite(String)

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

System_CAPS_pubmethodSystem_CAPS_staticReadAllBytes(String)

Открывает двоичный файл, считывает содержимое файла в массив байтов и затем закрывает файл.

System_CAPS_pubmethodSystem_CAPS_staticReadAllLines(String)

Открывает текстовый файл, считывает все строки файла и затем закрывает файл.

System_CAPS_pubmethodSystem_CAPS_staticReadAllLines(String, Encoding)

Открывает файл, считывает все строки файла с заданной кодировкой и затем закрывает файл.

System_CAPS_pubmethodSystem_CAPS_staticReadAllText(String)

Открывает текстовый файл, считывает все строки файла и затем закрывает файл.

System_CAPS_pubmethodSystem_CAPS_staticReadAllText(String, Encoding)

Открывает файл, считывает все строки файла с заданной кодировкой и затем закрывает файл.

System_CAPS_pubmethodSystem_CAPS_staticReadLines(String)

Считывает строки файла.

System_CAPS_pubmethodSystem_CAPS_staticReadLines(String, Encoding)

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

System_CAPS_pubmethodSystem_CAPS_staticReplace(String, String, String)

Заменяет содержимое заданного файла на содержимое другого файла, удаляя исходный файл и создавая резервную копию замененного файла.

System_CAPS_pubmethodSystem_CAPS_staticReplace(String, String, String, Boolean)

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

System_CAPS_pubmethodSystem_CAPS_staticSetAccessControl(String, FileSecurity)

Применяет записи списка управления доступом (ACL), описанные объектом FileSecurity, к заданному файлу.

System_CAPS_pubmethodSystem_CAPS_staticSetAttributes(String, FileAttributes)

Устанавливает заданные атрибуты FileAttributes файла по заданному пути.

System_CAPS_pubmethodSystem_CAPS_staticSetCreationTime(String, DateTime)

Устанавливает дату и время создания файла.

System_CAPS_pubmethodSystem_CAPS_staticSetCreationTimeUtc(String, DateTime)

Устанавливает дату и время создания файла, представленные в формате общего скоординированного времени (UTC).

System_CAPS_pubmethodSystem_CAPS_staticSetLastAccessTime(String, DateTime)

Устанавливаются дата и время последнего доступа к заданному файлу.

System_CAPS_pubmethodSystem_CAPS_staticSetLastAccessTimeUtc(String, DateTime)

Устанавливает дату и время последнего доступа к заданному файлу в формате всемирного координированного времени (UTC).

System_CAPS_pubmethodSystem_CAPS_staticSetLastWriteTime(String, DateTime)

Устанавливаются дата и время последней операции записи в заданный файл.

System_CAPS_pubmethodSystem_CAPS_staticSetLastWriteTimeUtc(String, DateTime)

Устанавливает дату и время последней операции записи в заданный файл в формате всемирного координированного времени (UTC).

System_CAPS_pubmethodSystem_CAPS_staticWriteAllBytes(String, Byte[])

Создает новый файл, записывает в него указанный массив байтов и затем закрывает файл. Если целевой файл уже существует, он будет переопределен.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, IEnumerable<String>)

Создает новый файл, записывает в него коллекцию строк, затем закрывает файл.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, IEnumerable<String>, Encoding)

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

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, String[])

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

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, String[], Encoding)

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

System_CAPS_pubmethodSystem_CAPS_staticWriteAllText(String, String)

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

System_CAPS_pubmethodSystem_CAPS_staticWriteAllText(String, String, Encoding)

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

System_CAPS_noteПримечание

Чтобы просмотреть исходный код .NET Framework для этого типа, см. раздел Reference Source. Просмотр исходного кода в Интернете, загружаемом справочнике для автономного просмотра и пошагово источники (включая исправления и обновления) во время отладки; see instructions.

Используйте File класса для обычных операций, таких как копирование, перемещение, переименование, создание, открытие, удаление и добавление в один файл одновременно. Можно также использовать File класса для получения и установки атрибутов файла или DateTime сведения, связанные с созданием доступа и записи в файл. Если вы хотите выполнять операции над несколькими файлами, см. раздел Directory.GetFiles или DirectoryInfo.GetFiles.

Многие File методы возвращают другие типы ввода-вывода при создании или открытии файла. Эти другие типы можно использовать для дальнейших операций с файлом. Дополнительные сведения см. в разделе определенных File такие элементы, как OpenText, CreateText, или Create.

Так как все File методы являются статическими, может быть более эффективно использовать File метода вместо соответствующего FileInfo метод экземпляра, если требуется выполнить только одно действие. Все File методов требуется путь к файлу, используемых для манипуляции.

Статические методы File класса выполняют проверку безопасности для всех методов. Если вы собираетесь использовать объект неоднократно, рекомендуется использовать соответствующий метод экземпляра FileInfo так как проверка безопасности не всегда будет использоваться необходимые.

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

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

Перечисление

Описание

FileAccess

Указывает, чтение и запись в файл.

FileShare

Задает уровень разрешенного доступа для файла, который уже используется.

FileMode

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

System_CAPS_noteПримечание

В членах, которые принимают путь в качестве входной строки этот путь должен иметь правильный формат или возникает исключение. Например если путь является полным, но начинается с пробела, путь не усекаются в методы класса. Таким образом путь сформирован, и возникает исключение. Аналогично нельзя дважды ввести полный путь или сочетание путей. Например «c:\temp c:\windows» вызывает исключение в большинстве случаев. Убедитесь в наличии правильного формата пути при использовании методов, работающих со строкой пути.

В членах, которые принимают путь путь можно указывать файл или каталог. Указанный путь может относиться и относительный путь или путь соглашения об универсальных именах (UNC) для имени сервера и общего ресурса. Например все ниже показаны допустимые пути:

  • «c:\\MyDir\\MyFile.txt» в C#, или «c:\MyDir\MyFile.txt» в Visual Basic.

  • «c:\\MyDir» в C#, или «c:\MyDir» в Visual Basic.

  • «MyDir\\MySubdir» в C# или «MyDir\MySubDir» в Visual Basic.

  • «\\\MyServer\\MyShare» в C#, или «\\MyServer\MyShare» в Visual Basic.

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

В следующем примере демонстрируется использование File класс для проверки, является ли файл существует, и в зависимости от результата, либо создайте новый файл и запись в него, или откройте существующий файл и читать из него. Перед выполнением кода, создание c:\temp папки.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

Универсальная платформа Windows
Доступно с 10
.NET Framework
Доступно с 1.1
Silverlight
Доступно с 2.0
Windows Phone Silverlight
Доступно с 7.0

Любые открытые статические элементы ( Предоставлен общий доступ в Visual Basic) этого типа являются потокобезопасными. Потокобезопасность элементов экземпляров не гарантируется.

Вернуться в начало
Показ: