FileSystemProxy.WriteAllText Metoda

Definice

Obor názvů:: Microsoft.VisualBasic.MyServices

Sestavení:: Microsoft.VisualBasic.dll

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í

Name	Description
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 -> unit

Public 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í hodnota je False.

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 je to cesta zařízení (začíná na \\.\); končí koncové lomítko.

ArgumentNullException

file je Nothing.

FileNotFoundException

Soubor neexistuje.

IOException

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

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

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

OutOfMemoryException

Pro zápis řetězce do vyrovnávací paměti není dostatek 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 zapíše názvy souborů ve Documents and Settings složce do FileList.txt, vložení návratu na začátek řádku mezi každou z nich 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. 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, bude zadané kódování ignorováno.

Note

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 jen jednou. Další informace najdete v metodě OpenTextFileWriter.

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

To	Podívejte se
Zápis textu do souboru	Postupy: Zápis textu do souborů
Připojení textu k souboru	Postupy: Připojení k textovým souborům

Viz také

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 -> unit

Public 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í hodnota 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

ArgumentException

ArgumentNullException

file je Nothing.

FileNotFoundException

Soubor neexistuje.

IOException

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

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

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

OutOfMemoryException

Pro zápis řetězce do vyrovnávací paměti není dostatek 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 zapíše názvy souborů ve Documents and Settings složce do FileList.txt, vložení návratu na začátek řádku mezi každou z nich 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.

Note

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

To	Podívejte se
Zápis textu do souboru	Postupy: Zápis textu do souborů
Připojení textu k souboru	Postupy: Připojení k textovým souborům

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?