File.ReadAllLines Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Membuka file teks, membaca semua baris file ke dalam array string, lalu menutup file.

Overload

ReadAllLines(String)	Membuka file teks, membaca semua baris file, lalu menutup file.
ReadAllLines(String, Encoding)	Membuka file, membaca semua baris file dengan pengodean yang ditentukan, lalu menutup file.

ReadAllLines(String)

Sumber:

File.cs

Membuka file teks, membaca semua baris file, lalu menutup 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()

Parameter

path

String

File yang akan dibuka untuk dibaca.

Mengembalikan

String[]

Array string yang berisi semua baris file.

Pengecualian

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path adalah string panjang nol, hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars()

ArgumentNullException

pathadalah null.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

DirectoryNotFoundException

Jalur yang ditentukan tidak valid (misalnya, ada di drive yang tidak dipetakan).

IOException

Terjadi kesalahan I/O saat membuka file.

UnauthorizedAccessException

path menentukan file yang bersifat baca-saja.

-atau-

Operasi ini tidak didukung pada platform saat ini.

-atau-

path menentukan direktori.

-atau-

Pemanggil tidak memiliki izin yang diperlukan.

FileNotFoundException

File yang ditentukan di path tidak ditemukan.

NotSupportedException

path dalam format yang tidak valid.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

Contoh

Contoh kode berikut menunjukkan penggunaan ReadAllLines metode untuk menampilkan konten file. Dalam contoh ini, file dibuat, jika belum ada, dan teks ditambahkan ke dalamnya.

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

open System
open System.IO

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    let createText = [ "Hello"; "And"; "Welcome" ]
    File.WriteAllLines(path, createText)

// This text is always added, making the file longer over time
// if it is not deleted.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText)

// Open the file to read from.
let readText = File.ReadAllLines path

for s in readText do
    printfn $"{s}"

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

Keterangan

Metode ini membuka file, membaca setiap baris file, lalu menambahkan setiap baris sebagai elemen array string. Kemudian menutup file. Garis didefinisikan sebagai urutan karakter diikuti dengan pengembalian pengangkutan ('\r'), umpan baris ('\n'), atau pengembalian pengangkutan segera diikuti oleh umpan baris. String yang dihasilkan tidak berisi penghentian pengembalian pengangkutan dan/atau umpan baris.

Metode ini mencoba mendeteksi pengodean file secara otomatis berdasarkan keberadaan tanda urutan byte. Format pengodean UTF-8 dan UTF-32 (baik big-endian maupun little-endian) dapat dideteksi.

Lihat juga

• I/O File dan Aliran
• Membaca teks dari file
• Cara: Menulis Teks ke File
• Cara: Membaca dan Menulis ke File Data yang Baru Dibuat

ReadAllLines(String, Encoding)

Sumber:

File.cs

Membuka file, membaca semua baris file dengan pengodean yang ditentukan, lalu menutup 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[]

Public Shared Function ReadAllLines (path As String, encoding As Encoding) As String()

Parameter

path

String

File yang akan dibuka untuk dibaca.

encoding

Encoding

Pengodean diterapkan ke konten file.

Mengembalikan

String[]

Array string yang berisi semua baris file.

Pengecualian

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path adalah string panjang nol, hanya berisi spasi kosong, atau berisi satu atau beberapa karakter yang tidak valid. Anda bisa mengkueri karakter yang tidak valid dengan menggunakan metode .GetInvalidPathChars()

ArgumentNullException

pathadalah null.

PathTooLongException

Jalur yang ditentukan, nama file, atau keduanya melebihi panjang maksimum yang ditentukan sistem.

DirectoryNotFoundException

Jalur yang ditentukan tidak valid (misalnya, ada di drive yang tidak dipetakan).

IOException

Terjadi kesalahan I/O saat membuka file.

UnauthorizedAccessException

path menentukan file yang bersifat baca-saja.

-atau-

Operasi ini tidak didukung pada platform saat ini.

-atau-

path menentukan direktori.

-atau-

Pemanggil tidak memiliki izin yang diperlukan.

FileNotFoundException

File yang ditentukan di path tidak ditemukan.

NotSupportedException

path dalam format yang tidak valid.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

Contoh

Contoh kode berikut menunjukkan penggunaan ReadAllLines metode untuk menampilkan konten file. Dalam contoh ini, file dibuat, jika belum ada, dan teks ditambahkan ke dalamnya.

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

open System
open System.IO
open System.Text

let path = @"c:\temp\MyTest.txt"

// This text is added only once to the file.
if File.Exists path |> not then
    // Create a file to write to.
    let 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.
let appendText =
    "This is extra text" + Environment.NewLine

File.AppendAllText(path, appendText, Encoding.UTF8)

// Open the file to read from.
let readText = File.ReadAllLines(path, Encoding.UTF8)

for s in readText do
    printfn $"{s}"

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

Keterangan

Metode ini membuka file, membaca setiap baris file, lalu menambahkan setiap baris sebagai elemen array string. Kemudian menutup file. Garis didefinisikan sebagai urutan karakter diikuti dengan pengembalian pengangkutan ('\r'), umpan baris ('\n'), atau pengembalian pengangkutan segera diikuti oleh umpan baris. String yang dihasilkan tidak berisi penghentian pengembalian pengangkutan dan/atau umpan baris.

Metode ini mencoba mendeteksi pengodean file secara otomatis berdasarkan keberadaan tanda urutan byte. Format pengodean UTF-8 dan UTF-32 (baik big-endian maupun little-endian) dapat dideteksi.

Lihat juga

• I/O File dan Aliran
• Membaca teks dari file
• Cara: Menulis Teks ke File
• Cara: Membaca dan Menulis ke File Data yang Baru Dibuat