FileSystem.ReadAllText Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.FileIO

Sestavení:

Microsoft.VisualBasic.Core.dll

Vrátí obsah textového souboru jako String.

Přetížení

ReadAllText(String)	Vrátí obsah textového souboru jako String.
ReadAllText(String, Encoding)	Vrátí obsah textového souboru jako String.

ReadAllText(String)

Zdroj:

FileSystem.vb

Vrátí obsah textového souboru jako String.

public:
 static System::String ^ ReadAllText(System::String ^ file);

public static string ReadAllText (string file);

static member ReadAllText : string -> string

Public Shared Function ReadAllText (file As String) As String

Parametry

file

String

Název a cesta k souboru, který chcete přečíst.

Návraty

String

String obsahující obsah 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á jiným procesem nebo dojde k chybě vstupně-výstupních operací.

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

K zápisu ř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 načte obsah souboru do řetězce a pak ho Test.txt zobrazí v okně se zprávou.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

Tento příklad načte obsah souboru Test.txt ASCII do řetězce a pak ho zobrazí v okně se zprávou.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
   System.Text.Encoding.ASCII)
MsgBox(reader)

Poznámky

Metoda ReadAllText objektu My.Computer.FileSystem umožňuje číst z textového souboru. Obsah souboru se vrátí jako řetězec.

Kódování souboru lze zadat, pokud je obsah souboru v kódování, jako je ASCII nebo UTF-8. Pokud čtete ze souboru s rozšířenými znaky, musíte zadat kódování souboru pomocí jiného ReadAllText přetížení metody.

Nečiňte rozhodnutí o obsahu souboru na základě jeho názvu. Například soubor Form1.vb nemusí být zdrojovým souborem jazyka Visual Basic. Před použitím dat ve své aplikaci ověřte všechny vstupy.

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.FileSystem.ReadAllText .

Záměr	Seznamte se s
Čtení z textového souboru	Postupy: Čtení z textových souborů v jazyce Visual Basic

Viz také

• Encoding
• ReadAllText
• StreamReader(Stream, Encoding)

ReadAllText(String, Encoding)

Zdroj:

FileSystem.vb

Vrátí obsah textového souboru jako String.

public:
 static System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);

public static string ReadAllText (string file, System.Text.Encoding encoding);

static member ReadAllText : string * System.Text.Encoding -> string

Public Shared Function ReadAllText (file As String, encoding As Encoding) As String

Parametry

file

String

Název a cesta k souboru, který chcete přečíst.

encoding

Encoding

Kódování znaků, které se má použít při čtení souboru. Výchozí hodnota je UTF-8.

Návraty

String

String obsahující obsah 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á jiným procesem nebo dojde k chybě vstupně-výstupních operací.

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

K zápisu ř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 načte obsah souboru do řetězce a pak ho Test.txt zobrazí v okně se zprávou.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)

Tento příklad načte obsah souboru Test.txt ASCII do řetězce a pak ho zobrazí v okně se zprávou.

Dim reader = My.Computer.FileSystem.ReadAllText("C:\test.txt",
   System.Text.Encoding.ASCII)
MsgBox(reader)

Poznámky

Metoda ReadAllText objektu My.Computer.FileSystem umožňuje číst z textového souboru. Obsah souboru se vrátí jako řetězec.

Kódování souboru lze zadat, pokud je obsah souboru v kódování, jako je ASCII nebo UTF-8. Pokud čtete ze souboru s rozšířenými znaky, musíte zadat kódování souboru.

Nečiňte rozhodnutí o obsahu souboru na základě jeho názvu. Například soubor Form1.vb nemusí být zdrojovým souborem jazyka Visual Basic. Před použitím dat ve své aplikaci ověřte všechny vstupy.

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.FileSystem.ReadAllText .

Záměr	Seznamte se s
Čtení z textového souboru	Postupy: Čtení z textových souborů v jazyce Visual Basic

Viz také

• Encoding
• StreamReader(Stream, Encoding)