Sdílet prostřednictvím


FileSystem.WriteAllText Metoda

Definice

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
Zdroj:
FileSystem.vb
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

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.

file je Nothing.

Soubor neexistuje.

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

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

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

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

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é

Platí pro

WriteAllText(String, String, Boolean, Encoding)

Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
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

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.

file je Nothing.

Soubor neexistuje.

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

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

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

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

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é

Platí pro