FileSystem.WriteAllText Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.FileIO

Sestavení:

Microsoft.VisualBasic.Core.dll

Zapíše text do souboru.

Přetížení

WriteAllText(String, String, Boolean)	Zapíše text do souboru.
WriteAllText(String, String, Boolean, Encoding)	Zapíše text do souboru.

WriteAllText(String, String, Boolean)

Zdroj:

FileSystem.vb

Zapíše text do souboru.

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)

Parametry

file

String

Soubor, do který se má zapsat.

text

String

Text, který se má zapsat do souboru.

append

Boolean

True připojit k obsahu souboru; False k přepsání obsahu souboru.

Výjimky

ArgumentException

Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\); končí koncovým lomítkem.

ArgumentNullException

file je Nothing.

FileNotFoundException

Soubor neexistuje.

IOException

Soubor se používá v jiném procesu nebo dojde k vstupně-výstupní chybě.

PathTooLongException

Cesta přesahuje systémem definovanou maximální délku.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

OutOfMemoryException

Není dostatek paměti pro zápis řetězce do vyrovnávací paměti.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

Příklady

Tento příklad zapíše řádek "This is new text to be added." do souboru Test.txta přepíše veškerý existující text v souboru.

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

Tento příklad zapisuje názvy souborů ve Documents and Settings složce do FileList.txtsouboru a pro lepší čitelnost vloží návrat na začátek řádku.

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

Poznámky

Kódování UTF-8 slouží k zápisu do souboru. Chcete-li zadat jiné kódování, použijte jiné přetížení WriteAllText metody.

Pokud zadaný soubor neexistuje, vytvoří se.

Pokud zadané kódování neodpovídá existujícímu kódování souboru, zadané kódování bude ignorováno.

Poznámka

Metoda WriteAllText otevře soubor, zapíše do něj a pak ho zavře. Kód, který používá metodu WriteAllText , je jednodušší než kód, který používá StreamWriter objekt. Pokud ale přidáváte řetězce do souboru pomocí smyčky, může objekt poskytnout lepší výkon, StreamWriter protože stačí soubor otevřít a zavřít pouze jednou. Další informace najdete v OpenTextFileWriter metodě .

Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.WriteAllText .

Záměr	Seznamte se s
Zápis textu do souboru	Postupy: Zápis textu do souborů v jazyce Visual Basic
Připojení textu k souboru	Postupy: Připojování k textovým souborům v jazyce Visual Basic

Viz také

• Encoding
• WriteAllText

WriteAllText(String, String, Boolean, Encoding)

Zdroj:

FileSystem.vb

Zapíše text do souboru.

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)

Parametry

file

String

Soubor, do který se má zapsat.

text

String

Text, který se má zapsat do souboru.

append

Boolean

True připojit k obsahu souboru; False k přepsání obsahu souboru.

encoding

Encoding

Jaké kódování použít při zápisu do souboru.

Výjimky

ArgumentException

Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\); končí koncovým lomítkem.

ArgumentNullException

file je Nothing.

FileNotFoundException

Soubor neexistuje.

IOException

Soubor se používá v jiném procesu nebo dojde k vstupně-výstupní chybě.

PathTooLongException

Cesta přesahuje systémem definovanou maximální délku.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

OutOfMemoryException

Není dostatek paměti pro zápis řetězce do vyrovnávací paměti.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

Příklady

Tento příklad zapíše řádek "This is new text to be added." do souboru Test.txta přepíše veškerý existující text v souboru.

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

Tento příklad zapisuje názvy souborů ve Documents and Settings složce do FileList.txtsouboru a pro lepší čitelnost vloží návrat na začátek řádku.

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

Poznámky

Pokud zadaný soubor neexistuje, vytvoří se.

Pokud zadané kódování neodpovídá existujícímu kódování souboru, zadané kódování bude ignorováno.

Poznámka

Metoda WriteAllText otevře soubor, zapíše do něj a pak ho zavře. Kód, který používá metodu WriteAllText , je jednodušší než kód, který používá StreamWriter objekt. Pokud ale přidáváte řetězce do souboru pomocí smyčky, může objekt poskytnout lepší výkon, StreamWriter protože stačí soubor otevřít a zavřít pouze jednou. Další informace najdete v OpenTextFileWriter metodě .

Následující tabulka uvádí příklady úloh zahrnujících metodu My.Computer.FileSystem.WriteAllText .

Záměr	Seznamte se s
Zápis textu do souboru	Postupy: Zápis textu do souborů v jazyce Visual Basic
Připojení textu k souboru	Postupy: Připojování k textovým souborům v jazyce Visual Basic

Viz také

• Encoding