FileSystemProxy.ReadAllText Metoda

  • Reference

Definice

Obor názvů:
Microsoft.VisualBasic.MyServices
Sestavení:
Microsoft.VisualBasic.dll
Sestavení:
Microsoft.VisualBasic.Forms.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)

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

public:
 System::String ^ ReadAllText(System::String ^ file);
public string ReadAllText (string file);
member this.ReadAllText : string -> string
Public 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á 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 přečte obsah souboru Test.txt do řetězce a pak ho zobrazí v okně se zprávou.

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

Tento příklad přeč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 čtení 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 určit 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ý soubor jazyka Visual Basic. Před použitím dat ve své aplikaci ověřte všechny vstupy.

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

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

Viz také

Platí pro

ReadAllText(String, Encoding)

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

public:
 System::String ^ ReadAllText(System::String ^ file, System::Text::Encoding ^ encoding);
public string ReadAllText (string file, System.Text.Encoding encoding);
member this.ReadAllText : string * System.Text.Encoding -> string
Public 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 mají 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á 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 přečte obsah souboru Test.txt do řetězce a pak ho zobrazí v okně se zprávou.

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

Tento příklad přeč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 čtení 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ý soubor jazyka Visual Basic. Před použitím dat ve své aplikaci ověřte všechny vstupy.

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

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

Viz také

Platí pro