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

Name	Description
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 öğesini seçin.

Özel durumlar

ArgumentException

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.

ArgumentNullException

file, Nothing'e eşittir.

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çimdedir) içeriyor.

OutOfMemoryException

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

SecurityException

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	H nasıl yapılır: Visual Basic
Dosyaya metin ekleme	H nasıl yapılır: Visual Basic

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 öğesini seçin.

encoding

Encoding

Dosyaya yazarken kullanılacak kodlama.

Özel durumlar

ArgumentException

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.

ArgumentNullException

file, Nothing'e eşittir.

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çimdedir) içeriyor.

OutOfMemoryException

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

SecurityException

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	H nasıl yapılır: Visual Basic
Dosyaya metin ekleme	H nasıl yapılır: Visual Basic

Ayrıca bkz.

• Encoding