File.ReadAllLines File.ReadAllLines File.ReadAllLines File.ReadAllLines Method

Определение

Открывает текстовый файл, считывает все строки файла в массив строк и затем закрывает файл. Opens a text file, reads all lines of the file into a string array, and then closes the file.

Перегрузки

ReadAllLines(String) ReadAllLines(String) ReadAllLines(String) ReadAllLines(String)

Открывает текстовый файл, считывает все строки файла и затем закрывает файл. Opens a text file, reads all lines of the file, and then closes the file.

ReadAllLines(String, Encoding) ReadAllLines(String, Encoding) ReadAllLines(String, Encoding)

Открывает файл, считывает все строки файла с заданной кодировкой и затем закрывает файл. Opens a file, reads all lines of the file with the specified encoding, and then closes the file.

ReadAllLines(String) ReadAllLines(String) ReadAllLines(String) ReadAllLines(String)

Открывает текстовый файл, считывает все строки файла и затем закрывает файл. Opens a text file, reads all lines of the file, and then closes the file.

public:
 static cli::array <System::String ^> ^ ReadAllLines(System::String ^ path);
public static string[] ReadAllLines (string path);
static member ReadAllLines : string -> string[]
Public Shared Function ReadAllLines (path As String) As String()
Параметры
path
String String String String

Файл, открываемый для чтения. The file to open for reading.

Возвраты
String[]

Массив строк, содержащий все строки файла. A string array containing all lines of the file.

Исключения

path представляет собой строку нулевой длины, содержащую только пробелы или один или несколько недопустимых символов, заданных методом InvalidPathChars. path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

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

Указанный путь, имя файла или оба значения превышают максимальную длину, заданную в системе. The specified path, file name, or both exceed the system-defined maximum length.

Указан недопустимый путь (например, он ведет на несопоставленный диск). The specified path is invalid (for example, it is on an unmapped drive).

При открытии файла произошла ошибка ввода-вывода. An I/O error occurred while opening the file.

Параметр path указывает файл, доступный только для чтения. path specified a file that is read-only. - или - -or- Эта операция не поддерживается на текущей платформе. This operation is not supported on the current platform. - или - -or- path задает каталог. path specified a directory. - или - -or- У вызывающего объекта отсутствует необходимое разрешение. The caller does not have the required permission.

Файл, заданный параметром path, не найден. The file specified in path was not found.

Параметр path задан в недопустимом формате. path is in an invalid format.

У вызывающего объекта отсутствует необходимое разрешение. The caller does not have the required permission.

Примеры

В следующем примере кода демонстрируется использование ReadAllLines метод для отображения содержимого файла.The following code example demonstrates the use of the ReadAllLines method to display the contents of a file. В этом примере создается файл, если он еще не существует, и текст добавляется к нему.In this example a file is created, if it doesn't already exist, and text is added to it.

using System;
using System.IO;
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);
        }

        // 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);

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

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim sw As StreamWriter

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText() As String = {"Hello", "And", "Welcome"}
            File.WriteAllLines(path, createText)
        End If

        ' This text is always added, making the file longer over time
        ' if it is not deleted.
        Dim appendText As String = "This is extra text" + Environment.NewLine
        File.AppendAllText(path, appendText)

        ' Open the file to read from.
        Dim readText() As String = File.ReadAllLines(path)
        Dim s As String
        For Each s In readText
            Console.WriteLine(s)
        Next
    End Sub
End Class

Комментарии

Этот метод открывает файл, считывает каждую строку файла, а затем добавляет каждую строку в качестве элемента массива строк.This method opens a file, reads each line of the file, then adds each line as an element of a string array. Затем он закрывает файл.It then closes the file. Строка определяется как последовательность символов, а затем с помощью символа возврата каретки (\r), перевода строки («\n») или символ возврата каретки сразу следует строка перевода.A line is defined as a sequence of characters followed by a carriage return ('\r'), a line feed ('\n'), or a carriage return immediately followed by a line feed. Результирующая строка не содержит завершающий символ возврата каретки или перевода строки.The resulting string does not contain the terminating carriage return and/or line feed.

Этот метод пытается автоматически определить кодировку файла на основе наличия меток порядка следования байтов.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Форматы кодировок UTF-8 и UTF-32 (с прямым порядком байтов и с прямым порядком байтов) могут быть обнаружены.Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Безопасность

FileIOPermission
для доступа на чтение из файла или каталога. for access to read from a file or directory. Связанное перечисление: Read Associated enumeration: Read

См. также

ReadAllLines(String, Encoding) ReadAllLines(String, Encoding) ReadAllLines(String, Encoding)

Открывает файл, считывает все строки файла с заданной кодировкой и затем закрывает файл. Opens a file, reads all lines of the file with the specified encoding, and then closes the file.

public:
 static cli::array <System::String ^> ^ ReadAllLines(System::String ^ path, System::Text::Encoding ^ encoding);
public static string[] ReadAllLines (string path, System.Text.Encoding encoding);
static member ReadAllLines : string * System.Text.Encoding -> string[]
Параметры
path
String String String String

Файл, открываемый для чтения. The file to open for reading.

encoding
Encoding Encoding Encoding Encoding

Кодировка, примененная к содержимому файла. The encoding applied to the contents of the file.

Возвраты
String[]

Массив строк, содержащий все строки файла. A string array containing all lines of the file.

Исключения

path представляет собой строку нулевой длины, содержащую только пробелы или один или несколько недопустимых символов, заданных методом InvalidPathChars. path is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

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

Указанный путь, имя файла или оба значения превышают максимальную длину, заданную в системе. The specified path, file name, or both exceed the system-defined maximum length.

Указан недопустимый путь (например, он ведет на несопоставленный диск). The specified path is invalid (for example, it is on an unmapped drive).

При открытии файла произошла ошибка ввода-вывода. An I/O error occurred while opening the file.

Параметр path указывает файл, доступный только для чтения. path specified a file that is read-only. - или - -or- Эта операция не поддерживается на текущей платформе. This operation is not supported on the current platform. - или - -or- path задает каталог. path specified a directory. - или - -or- У вызывающего объекта отсутствует необходимое разрешение. The caller does not have the required permission.

Файл, заданный параметром path, не найден. The file specified in path was not found.

Параметр path задан в недопустимом формате. path is in an invalid format.

У вызывающего объекта отсутствует необходимое разрешение. The caller does not have the required permission.

Примеры

В следующем примере кода демонстрируется использование ReadAllLines метод для отображения содержимого файла.The following code example demonstrates the use of the ReadAllLines method to display the contents of a file. В этом примере создается файл, если он еще не существует, и текст добавляется к нему.In this example a file is created, if it doesn't already exist, and text is added to it.

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);
        }
    }
}
Imports System
Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim sw As StreamWriter

        ' This text is added only once to the file.
        If File.Exists(path) = False Then

            ' Create a file to write to.
            Dim createText() As String = {"Hello", "And", "Welcome"}
            File.WriteAllLines(path, createText, Encoding.UTF8)
        End If

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

        ' Open the file to read from.
        Dim readText() As String = File.ReadAllLines(path, Encoding.UTF8)
        Dim s As String
        For Each s In readText
            Console.WriteLine(s)
        Next
    End Sub
End Class

Комментарии

Этот метод открывает файл, считывает каждую строку файла, а затем добавляет каждую строку как элемент массива строк.This method opens a file, reads each line of the file, and then adds each line as an element of a string array. Затем он закрывает файл.It then closes the file. Строка определяется как последовательность символов, а затем с помощью символа возврата каретки (\r), перевода строки («\n») или символ возврата каретки сразу следует строка перевода.A line is defined as a sequence of characters followed by a carriage return ('\r'), a line feed ('\n'), or a carriage return immediately followed by a line feed. Результирующая строка не содержит завершающий символ возврата каретки или перевода строки.The resulting string does not contain the terminating carriage return and/or line feed.

Этот метод пытается автоматически определить кодировку файла на основе наличия меток порядка следования байтов.This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Форматы кодировок UTF-8 и UTF-32 (с прямым порядком байтов и с прямым порядком байтов) могут быть обнаружены.Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected.

Безопасность

FileIOPermission
для доступа на чтение из файла или каталога. for access to read from a file or directory. Связанное перечисление: Read Associated enumeration: Read

См. также

Применяется к