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

Метод File.ReadAllLines (String, Encoding)

 

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

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

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

public static string[] ReadAllLines(
	string path,
	Encoding encoding
)

Параметры

path
Type: System.String

Файл, открываемый для чтения.

encoding
Type: System.Text.Encoding

Кодировка, примененная к содержимому файла.

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

Type: System.String[]

Массив строк, содержащий все строки файла.

Exception Condition
ArgumentException

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

ArgumentNullException

Свойство path имеет значение null.

PathTooLongException

Указанный путь, имя файла или оба значения превышают максимальную длину, заданную в системе. Например, для платформ на основе Windows длина пути должна составлять менее 248 знаков, а длина имен файлов — менее 260 знаков.

DirectoryNotFoundException

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

IOException

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

UnauthorizedAccessException

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

-или-

Эта операция не поддерживается на текущей платформе.

-или-

path определяет каталог.

-или-

У вызывающего объекта отсутствует необходимое разрешение.

FileNotFoundException

Файл, заданный параметром path, не найден.

NotSupportedException

Параметр path задан в недопустимом формате.

SecurityException

У вызывающего объекта отсутствует необходимое разрешение.

Этот метод открывает файл, считывает каждую строку файла и затем добавляет каждую строку в качестве элемента массива строк. Затем он закрывает файл. Строка определяется как последовательность символов, затем символы возврата каретки (\r), символ перевода строки («\n») или символ возврата каретки сразу следуют строки перевода. Результирующая строка не содержит завершающий символ возврата каретки или перевода строки.

Этот метод пытается автоматически определить кодировку файла на основе наличия меток порядка следования байтов. Форматы кодировок UTF-8 и UTF-32 (с прямым порядком байтов и с прямым порядком байтов) могут быть обнаружены.

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

using System;
using System.IO;
using System.Text;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        // This text is added only once to the file.
        if (!File.Exists(path))
        {
            // Create a file to write to.
            string[] createText = { "Hello", "And", "Welcome" };
            File.WriteAllLines(path, createText, Encoding.UTF8);
        }

        // This text is always added, making the file longer over time
        // if it is not deleted.
        string appendText = "This is extra text" + Environment.NewLine;
        File.AppendAllText(path, appendText, Encoding.UTF8);

        // Open the file to read from.
        string[] readText = File.ReadAllLines(path, Encoding.UTF8);
        foreach (string s in readText)
        {
            Console.WriteLine(s);
        }
    }
}

FileIOPermission

for access to read from a file or directory. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Read

Универсальная платформа Windows
Доступно с 10
.NET Framework
Доступно с 2.0
Вернуться в начало
Показ: