FileSystem.WriteAllText Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic.FileIO

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Core.dll

Dosyaya metin yazar.

Aşırı Yüklemeler

WriteAllText(String, String, Boolean)	Dosyaya metin yazar.
WriteAllText(String, String, Boolean, Encoding)	Dosyaya metin yazar.

WriteAllText(String, String, Boolean)

Kaynak:

FileSystem.vb

Dosyaya metin yazar.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append);

public static void WriteAllText (string file, string text, bool append);

static member WriteAllText : string * string * bool -> unit

Public Shared 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 dosyasının içeriğinin üzerine yazılmasını sağlayın.

Özel durumlar

ArgumentException

Yol aşağıdaki nedenlerden biri için geçerli değildir: 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.

ArgumentNullException

file, Nothing değeridir.

FileNotFoundException

Dosya yok.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

Arabelleğe dize yazmak için yeterli bellek yok.

SecurityException

Kullanıcının yolu görüntülemek için gerekli izinleri yok.

Örnekler

Bu örnek, dosyasının satırını "This is new text to be added." yazar ve dosyadaki Test.txtvar olan 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.

Not

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, döngü kullanarak bir dosyaya dize ekliyorsanız, dosyayı yalnızca bir StreamWriter kez açıp kapatmanız gerektiğinden, bir nesne daha iyi performans sağlayabilir. Daha fazla bilgi için yöntemine OpenTextFileWriter bakın.

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

Amaç	Bkz.
Dosyaya metin yazma	Nasıl Yapılır: Visual Basic'te Dosyalara Metin Yazma
Bir dosyaya metin ekleme	Nasıl Yapılır: Visual Basic'te Metin Dosyalarına Ekleme

Ayrıca bkz.

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

Kaynak:

FileSystem.vb

Dosyaya metin yazar.

public:
 static void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);

public static void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);

static member WriteAllText : string * string * bool * System.Text.Encoding -> unit

Public Shared 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 dosyasının içeriğinin üzerine yazılmasını sağlayın.

encoding

Encoding

Dosyaya yazarken kullanılacak kodlama.

Özel durumlar

ArgumentException

Yol aşağıdaki nedenlerden biri için geçerli değildir: 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.

ArgumentNullException

file, Nothing değeridir.

FileNotFoundException

Dosya yok.

IOException

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

PathTooLongException

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

NotSupportedException

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

OutOfMemoryException

Arabelleğe dize yazmak için yeterli bellek yok.

SecurityException

Kullanıcının yolu görüntülemek için gerekli izinleri yok.

Örnekler

Bu örnek, dosyasının satırını "This is new text to be added." yazar ve dosyadaki Test.txtvar olan 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.

Not

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, döngü kullanarak bir dosyaya dize ekliyorsanız, dosyayı yalnızca bir StreamWriter kez açıp kapatmanız gerektiğinden, bir nesne daha iyi performans sağlayabilir. Daha fazla bilgi için yöntemine OpenTextFileWriter bakın.

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

Amaç	Bkz.
Dosyaya metin yazma	Nasıl Yapılır: Visual Basic'te Dosyalara Metin Yazma
Bir dosyaya metin ekleme	Nasıl Yapılır: Visual Basic'te Metin Dosyalarına Ekleme

Ayrıca bkz.

• Encoding