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 は長さ 0 の文字列で、空白のみで構成されるか、または InvalidPathChars で定義される 1 つ以上の正しくない文字を含んでいます。is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。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).

ファイルを開くときに、I/O エラーが発生しました。An I/O error occurred while opening the file.

path が読み取り専用のファイルを指定しました。specified a file that is read-only.

または-or- この操作は、現在のプラットフォームではサポートされていません。This operation is not supported on the current platform.

または-or- path がディレクトリを指定しました。specified a directory.

または-or- 呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

path で指定されたファイルが見つかりませんでした。The file specified in path was not found.

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. 関連付けられた列挙体。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 は長さ 0 の文字列で、空白のみで構成されるか、または InvalidPathChars で定義される 1 つ以上の正しくない文字を含んでいます。is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

指定したパス、ファイル名、またはその両方がシステム定義の最大長を超えています。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).

ファイルを開くときに、I/O エラーが発生しました。An I/O error occurred while opening the file.

path が読み取り専用のファイルを指定しました。specified a file that is read-only.

または-or- この操作は、現在のプラットフォームではサポートされていません。This operation is not supported on the current platform.

または-or- path がディレクトリを指定しました。specified a directory.

または-or- 呼び出し元に、必要なアクセス許可がありません。The caller does not have the required permission.

path で指定されたファイルが見つかりませんでした。The file specified in path was not found.

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. 関連付けられた列挙体。Associated enumeration: Read

こちらもご覧ください

適用対象