FileSystemProxy.ReadAllText Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.MyServices

Sestavení:

Microsoft.VisualBasic.dll

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

Přetížení

Name	Description
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ý se má 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 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 přečte obsah Test.txt řetězce a pak ho zobrazí v poli 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 poli 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 určit kódování souboru pomocí jiného ReadAllText přetížení metody.

Nerozhodujte o obsahu souboru na základě názvu souboru. Soubor Form1.vb například nemusí být zdrojovým souborem jazyka Visual Basic. Před použitím dat v aplikaci ověřte všechny vstupy.

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

To	Podívejte se
Čtení z textového souboru	Postupy: Čtení z textových souborů

Viz také

• Encoding
• ReadAllText(String)
• StreamReader(Stream, Encoding)
• Objekty (Visual Basic)
• Reading from Files in Visual Basic
• : Čtení textu ze souborů pomocí třídy StreamReader (Visual Basic)
• Řešení potíží: Čtení z textových souborů a zápis do nich
• Návod: Manipulace se soubory a adresáři v jazyce Visual Basic
• Kódování souborů

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ý se má 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 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 přečte obsah Test.txt řetězce a pak ho zobrazí v poli 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 poli 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 soubor s rozšířenými znaky, musíte zadat kódování souboru.

Nerozhodujte o obsahu souboru na základě názvu souboru. Soubor Form1.vb například nemusí být zdrojovým souborem jazyka Visual Basic. Před použitím dat v aplikaci ověřte všechny vstupy.

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

To	Podívejte se
Čtení z textového souboru	Postupy: Čtení z textových souborů

Viz také

• Encoding
• StreamReader(Stream, Encoding)
• Objekty (Visual Basic)
• Reading from Files in Visual Basic
• : Čtení textu ze souborů pomocí třídy StreamReader (Visual Basic)
• Řešení potíží: Čtení z textových souborů a zápis do nich
• Návod: Manipulace se soubory a adresáři v jazyce Visual Basic
• Kódování souborů