Bagikan melalui


FileSystemProxy.WriteAllText Metode

Definisi

Menulis teks ke file.

Overload

WriteAllText(String, String, Boolean)

Menulis teks ke file.

WriteAllText(String, String, Boolean, Encoding)

Menulis teks ke file.

WriteAllText(String, String, Boolean)

Menulis teks ke file.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append);
public void WriteAllText (string file, string text, bool append);
member this.WriteAllText : string * string * bool -> unit
Public Sub WriteAllText (file As String, text As String, append As Boolean)

Parameter

file
String

File yang akan ditulis.

text
String

Teks yang akan ditulis ke file.

append
Boolean

True untuk menambahkan ke konten file; False untuk menimpa isi file. Defaultnya adalah False.

Pengecualian

Jalur ini tidak valid karena salah satu alasan berikut: ini adalah string panjang nol; hanya berisi spasi kosong; berisi karakter yang tidak valid; atau ini adalah jalur perangkat (dimulai dengan \\.\); diakhir dengan garis miring berikutnya.

fileadalah Nothing.

File tidak ada.

File sedang digunakan oleh proses lain, atau terjadi kesalahan I/O.

Jalur melebihi panjang maksimum yang ditentukan sistem.

Nama file atau direktori di jalur berisi titik dua (:) atau dalam format yang tidak valid.

Memori tidak cukup untuk menulis string ke buffer.

Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur.

Contoh

Contoh ini menulis baris "This is new text to be added." ke file Test.txt, menimpa teks yang ada dalam file.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

Contoh ini menulis nama file di Documents and Settings folder ke FileList.txt, menyisipkan pengembalian pengangkutan di antara masing-masing untuk keterbacaan yang lebih baik.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Keterangan

Pengodean UTF-8 digunakan untuk menulis ke file. Untuk menentukan pengodean yang berbeda, gunakan kelebihan beban metode yang WriteAllText berbeda.

Apabila file yang ditentukan tidak ada, file akan dibuat.

Jika pengodean yang ditentukan tidak cocok dengan pengodean file yang ada, pengodean yang ditentukan akan diabaikan.

Catatan

Metode WriteAllText ini membuka file, menulis ke file tersebut, lalu menutupnya. Kode yang menggunakan WriteAllText metode ini lebih sederhana daripada kode yang menggunakan StreamWriter objek . Namun, jika Anda menambahkan string ke file dengan menggunakan perulangan, objek dapat memberikan performa yang StreamWriter lebih baik karena Anda hanya perlu membuka dan menutup file satu kali. Untuk informasi lebih lanjut, lihat OpenTextFileWritermetodenya.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.FileSystem.WriteAllText metode .

Untuk Lihat
Menulis teks ke file Cara: Menulis Teks ke File
Menambahkan teks ke file Cara: Menambahkan ke File Teks

Lihat juga

Berlaku untuk

WriteAllText(String, String, Boolean, Encoding)

Menulis teks ke file.

public:
 void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);
public void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);
member this.WriteAllText : string * string * bool * System.Text.Encoding -> unit
Public Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)

Parameter

file
String

File yang akan ditulis.

text
String

Teks yang akan ditulis ke file.

append
Boolean

True untuk menambahkan ke konten file; False untuk menimpa isi file. Defaultnya adalah False.

encoding
Encoding

Pengodean apa yang akan digunakan saat menulis ke file. Defaultnya adalah UTF-8.

Pengecualian

Jalur ini tidak valid karena salah satu alasan berikut: ini adalah string panjang nol; hanya berisi spasi kosong; berisi karakter yang tidak valid; atau ini adalah jalur perangkat (dimulai dengan \\.\); diakhir dengan garis miring berikutnya.

fileadalah Nothing.

File tidak ada.

File sedang digunakan oleh proses lain, atau terjadi kesalahan I/O.

Jalur melebihi panjang maksimum yang ditentukan sistem.

Nama file atau direktori di jalur berisi titik dua (:) atau dalam format yang tidak valid.

Memori tidak cukup untuk menulis string ke buffer.

Pengguna tidak memiliki izin yang diperlukan untuk melihat jalur.

Contoh

Contoh ini menulis baris "This is new text to be added." ke file Test.txt, menimpa teks yang ada dalam file.

My.Computer.FileSystem.WriteAllText("C:\TestFolder1\test.txt",
"This is new text to be added.", False)

Contoh ini menulis nama file di Documents and Settings folder ke FileList.txt, menyisipkan pengembalian pengangkutan di antara masing-masing untuk keterbacaan yang lebih baik.

For Each foundFile In
        My.Computer.FileSystem.GetFiles("C:\Documents and Settings")
    foundFile = foundFile & vbCrLf
    My.Computer.FileSystem.WriteAllText(
        "C:\Documents and Settings\FileList.txt", foundFile, True)
Next

Keterangan

Apabila file yang ditentukan tidak ada, file akan dibuat.

Jika pengodean yang ditentukan tidak cocok dengan pengodean file yang ada, pengodean yang ditentukan akan diabaikan.

Catatan

Metode WriteAllText ini membuka file, menulis ke file tersebut, lalu menutupnya. Kode yang menggunakan WriteAllText metode ini lebih sederhana daripada kode yang menggunakan StreamWriter objek . Namun, jika Anda menambahkan string ke file dengan menggunakan perulangan, objek dapat memberikan performa yang StreamWriter lebih baik karena Anda hanya perlu membuka dan menutup file satu kali. Untuk informasi lebih lanjut, lihat OpenTextFileWritermetodenya.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.FileSystem.WriteAllText metode .

Untuk Lihat
Menulis teks ke file Cara: Menulis Teks ke File
Menambahkan teks ke file Cara: Menambahkan ke File Teks

Lihat juga

Berlaku untuk