FileSystem.WriteAllText Metódus

Definíció

Névtér:

Microsoft.VisualBasic.FileIO

Szerelvény:

Microsoft.VisualBasic.Core.dll

Szöveget ír egy fájlba.

Túlterhelések

Name	Description
WriteAllText(String, String, Boolean)	Szöveget ír egy fájlba.
WriteAllText(String, String, Boolean, Encoding)	Szöveget ír egy fájlba.

WriteAllText(String, String, Boolean)

Forrás:

FileSystem.vb

Szöveget ír egy fájlba.

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)

Paraméterek

file

String

Fájl, amelybe meg kell írni.

text

String

Fájlba írandó szöveg.

append

Boolean

True a fájl tartalmának hozzáfűzése; False a fájl tartalmának felülírásához.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik); záró perjellel végződik.

ArgumentNullException

file az Nothing.

FileNotFoundException

A fájl nem létezik.

IOException

A fájlt egy másik folyamat használja, vagy I/O-hiba történik.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út fájl- vagy könyvtárneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

OutOfMemoryException

Nincs elég memória a sztring puffereléshez való írásához.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

Példák

Ez a példa írja a sort "This is new text to be added." a fájlba Test.txt, felülírva a fájl meglévő szövegét.

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

Ez a példa a mappában Documents and Settingslévő FileList.txt fájlok nevét írja be, és beszúr egy kocsivisszajelet az egyes fájlok között a jobb olvashatóság érdekében.

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

Megjegyzések

Az UTF-8 kódolás a fájlba való írásra szolgál. Másik kódolás megadásához használja a metódus eltérő túlterhelését WriteAllText .

Ha a megadott fájl nem létezik, létrejön.

Ha a megadott kódolás nem egyezik meg a fájl meglévő kódolásával, a rendszer figyelmen kívül hagyja a megadott kódolást.

Note

A WriteAllText metódus megnyit egy fájlt, ír rá, majd bezárja. A metódust WriteAllText használó kód egyszerűbb, mint az objektumot StreamWriter használó kód. Ha azonban sztringeket ad hozzá egy fájlhoz hurok használatával, az StreamWriter objektumok jobb teljesítményt nyújthatnak, mert csak egyszer kell megnyitnia és bezárnia a fájlt. További információkért tekintse meg a metódust OpenTextFileWriter .

Az alábbi táblázat példákat sorol fel a metódust érintő tevékenységekre My.Computer.FileSystem.WriteAllText .

Címzett	Nézze
Szöveg írása fájlba	Bemutató: Szöveg írása fájlokba a Visual Basic
Szöveg hozzáfűzése fájlhoz	Hogyan is: Szövegfájlok hozzáfűzése a Visual Basic

Lásd még

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

Forrás:

FileSystem.vb

Szöveget ír egy fájlba.

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)

Paraméterek

file

String

Fájl, amelybe meg kell írni.

text

String

Fájlba írandó szöveg.

append

Boolean

True a fájl tartalmának hozzáfűzése; False a fájl tartalmának felülírásához.

encoding

Encoding

Milyen kódolást kell használni a fájlba való íráshoz.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik); záró perjellel végződik.

ArgumentNullException

file az Nothing.

FileNotFoundException

A fájl nem létezik.

IOException

A fájlt egy másik folyamat használja, vagy I/O-hiba történik.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út fájl- vagy könyvtárneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

OutOfMemoryException

Nincs elég memória a sztring puffereléshez való írásához.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

Példák

Ez a példa írja a sort "This is new text to be added." a fájlba Test.txt, felülírva a fájl meglévő szövegét.

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

Ez a példa a mappában Documents and Settingslévő FileList.txt fájlok nevét írja be, és beszúr egy kocsivisszajelet az egyes fájlok között a jobb olvashatóság érdekében.

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

Megjegyzések

Ha a megadott fájl nem létezik, létrejön.

Ha a megadott kódolás nem egyezik meg a fájl meglévő kódolásával, a rendszer figyelmen kívül hagyja a megadott kódolást.

Note

A WriteAllText metódus megnyit egy fájlt, ír rá, majd bezárja. A metódust WriteAllText használó kód egyszerűbb, mint az objektumot StreamWriter használó kód. Ha azonban sztringeket ad hozzá egy fájlhoz hurok használatával, az StreamWriter objektumok jobb teljesítményt nyújthatnak, mert csak egyszer kell megnyitnia és bezárnia a fájlt. További információkért tekintse meg a metódust OpenTextFileWriter .

Az alábbi táblázat példákat sorol fel a metódust érintő tevékenységekre My.Computer.FileSystem.WriteAllText .

Címzett	Nézze
Szöveg írása fájlba	Bemutató: Szöveg írása fájlokba a Visual Basic
Szöveg hozzáfűzése fájlhoz	Hogyan is: Szövegfájlok hozzáfűzése a Visual Basic

Lásd még

• Encoding