FileSystemProxy.WriteAllText Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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)
Zapíše text do souboru.
public:
void WriteAllText(System::String ^ file, System::String ^ text, bool append);public void WriteAllText (string file, string text, bool append);member this.WriteAllText : string * string * bool -> unitPublic Sub WriteAllText (file As String, text As String, append As Boolean)Parametry
- file
- String
Soubor, do který se má zapisovat.
- 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ýchozí je False.
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á jiným procesem nebo dojde k chybě vstupně-výstupních operací.
Cesta překračuje maximální délku definovanou systémem.
Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
K zápisu řetězce do vyrovnávací paměti není dostatek 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)
V tomto příkladu se zapisují názvy souborů ve Documents and Settings složce do FileList.txtsložky a vloží se mezi každou z nich návratový znak pro lepší čitelnost.
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 se používá k zápisu do souboru. Pokud chcete 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, bude zadané kódování 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 jenom 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ů |
| Připojení textu k souboru | Postupy: Připojování k textovým souborům |
Viz také
- Encoding
- WriteAllText(String, String, Boolean)
- Objekty (Visual Basic)
- Zápis do souborů v jazyce Visual Basic
Platí pro
WriteAllText(String, String, Boolean, Encoding)
Zapíše text do souboru.
public:
void WriteAllText(System::String ^ file, System::String ^ text, bool append, System::Text::Encoding ^ encoding);public void WriteAllText (string file, string text, bool append, System.Text.Encoding encoding);member this.WriteAllText : string * string * bool * System.Text.Encoding -> unitPublic Sub WriteAllText (file As String, text As String, append As Boolean, encoding As Encoding)Parametry
- file
- String
Soubor, do který se má zapisovat.
- 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ýchozí je False.
- encoding
- Encoding
Jaké kódování se má použít při zápisu do souboru. Výchozí hodnota je UTF-8.
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á jiným procesem nebo dojde k chybě vstupně-výstupních operací.
Cesta překračuje maximální délku definovanou systémem.
Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.
K zápisu řetězce do vyrovnávací paměti není dostatek 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)
V tomto příkladu se zapisují názvy souborů ve Documents and Settings složce do FileList.txtsložky a vloží se mezi každou z nich návratový znak pro lepší čitelnost.
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, bude zadané kódování 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 jenom 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ů |
| Připojení textu k souboru | Postupy: Připojování k textovým souborům |
