FileSystemProxy.WriteAllText Yöntem

Tanım

Dosyaya metin yazar.

Aşırı Yüklemeler

Name Description
WriteAllText(String, String, Boolean)

Dosyaya metin yazar.

WriteAllText(String, String, Boolean, Encoding)

Dosyaya metin yazar.

WriteAllText(String, String, Boolean)

Kaynak:
FileSystemProxy.vb
Kaynak:
FileSystemProxy.vb
Kaynak:
FileSystemProxy.vb
Kaynak:
FileSystemProxy.vb
Kaynak:
FileSystemProxy.vb

Dosyaya metin yazar.

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)

Parametreler

file
String

Yazılacak dosya.

text
String

Dosyaya yazılacak metin.

append
Boolean

True dosyanın içeriğine eklemek için; False öğesini seçin. Varsayılan False değeridir.

Özel durumlar

Yol aşağıdaki nedenlerden biri için geçerli değil: sıfır uzunluklu bir dizedir; yalnızca boşluk içerir; geçersiz karakterler içeriyor; veya bir cihaz yoludur (\\.\ile başlar); sondaki eğik çizgiyle biter.

file, Nothing'e eşittir.

Dosya başka bir işlem tarafından kullanılıyor veya G/Ç hatası oluşuyor.

Yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

Yoldaki bir dosya veya dizin adı iki nokta üst üste (:) veya geçersiz biçimdedir) içeriyor.

Dizeyi arabelleğe yazmak için yeterli bellek yok.

Kullanıcı, yolu görüntülemek için gerekli izinlere sahip değil.

Örnekler

Bu örnek, satırı "This is new text to be added." dosyasına yazar ve dosyadaki Test.txtmevcut metnin üzerine yazar.

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

Bu örnek klasöründeki Documents and Settings dosyaların adlarını klasörüne FileList.txtyazar ve daha iyi okunabilirlik için bunların arasına bir satır başı ekler.

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

Açıklamalar

UTF-8 kodlaması, dosyaya yazmak için kullanılır. Farklı bir kodlama belirtmek için yönteminin farklı bir aşırı yüklemesini WriteAllText kullanın.

Belirtilen dosya yoksa oluşturulur.

Belirtilen kodlama dosyanın mevcut kodlaması ile eşleşmiyorsa, belirtilen kodlama yoksayılır.

Note

WriteAllText yöntemi bir dosyayı açar, dosyaya yazar ve ardından kapatır. yöntemini kullanan WriteAllText kod, nesne StreamWriter kullanan koddan daha basittir. Ancak, bir döngü kullanarak bir dosyaya dize ekliyorsanız, dosyayı yalnızca bir StreamWriter kez açıp kapatmanız gerektiğinden nesne daha iyi performans sağlayabilir. Daha fazla bilgi için bkz. OpenTextFileWriter yöntemi.

Aşağıdaki tabloda, yöntemini içeren My.Computer.FileSystem.WriteAllText görev örnekleri listelenmiştir.

İçin Bkz:
Dosyaya metin yazma Nasıl yapılır: Dosyalara Metin Yazma
Dosyaya metin ekleme Nasıl yapılır: Metin Dosyalarına Ekleme

Ayrıca bkz.

Şunlara uygulanır

WriteAllText(String, String, Boolean, Encoding)

Kaynak:
FileSystemProxy.vb
Kaynak:
FileSystemProxy.vb
Kaynak:
FileSystemProxy.vb
Kaynak:
FileSystemProxy.vb
Kaynak:
FileSystemProxy.vb

Dosyaya metin yazar.

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)

Parametreler

file
String

Yazılacak dosya.

text
String

Dosyaya yazılacak metin.

append
Boolean

True dosyanın içeriğine eklemek için; False öğesini seçin. Varsayılan False değeridir.

encoding
Encoding

Dosyaya yazarken kullanılacak kodlama. Varsayılan değer UTF-8'dir.

Özel durumlar

Yol aşağıdaki nedenlerden biri için geçerli değil: sıfır uzunluklu bir dizedir; yalnızca boşluk içerir; geçersiz karakterler içeriyor; veya bir cihaz yoludur (\\.\ile başlar); sondaki eğik çizgiyle biter.

file, Nothing'e eşittir.

Dosya başka bir işlem tarafından kullanılıyor veya G/Ç hatası oluşuyor.

Yol, sistem tarafından tanımlanan uzunluk üst sınırını aşıyor.

Yoldaki bir dosya veya dizin adı iki nokta üst üste (:) veya geçersiz biçimdedir) içeriyor.

Dizeyi arabelleğe yazmak için yeterli bellek yok.

Kullanıcı, yolu görüntülemek için gerekli izinlere sahip değil.

Örnekler

Bu örnek, satırı "This is new text to be added." dosyasına yazar ve dosyadaki Test.txtmevcut metnin üzerine yazar.

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

Bu örnek klasöründeki Documents and Settings dosyaların adlarını klasörüne FileList.txtyazar ve daha iyi okunabilirlik için bunların arasına bir satır başı ekler.

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

Açıklamalar

Belirtilen dosya yoksa oluşturulur.

Belirtilen kodlama dosyanın mevcut kodlaması ile eşleşmiyorsa, belirtilen kodlama yoksayılır.

Note

WriteAllText yöntemi bir dosyayı açar, dosyaya yazar ve ardından kapatır. yöntemini kullanan WriteAllText kod, nesne StreamWriter kullanan koddan daha basittir. Ancak, bir döngü kullanarak bir dosyaya dize ekliyorsanız, dosyayı yalnızca bir StreamWriter kez açıp kapatmanız gerektiğinden nesne daha iyi performans sağlayabilir. Daha fazla bilgi için bkz. OpenTextFileWriter yöntemi.

Aşağıdaki tabloda, yöntemini içeren My.Computer.FileSystem.WriteAllText görev örnekleri listelenmiştir.

İçin Bkz:
Dosyaya metin yazma Nasıl yapılır: Dosyalara Metin Yazma
Dosyaya metin ekleme Nasıl yapılır: Metin Dosyalarına Ekleme

Ayrıca bkz.

Şunlara uygulanır