FileSystem.ReadAllText Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.dll

Zwraca zawartość pliku tekstowego jako String.

Przeciążenia

Nazwa	Opis
ReadAllText(String)	Zwraca zawartość pliku tekstowego jako String.
ReadAllText(String, Encoding)	Zwraca zawartość pliku tekstowego jako String.

ReadAllText(String)

Zwraca zawartość pliku tekstowego 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

Nazwa i ścieżka pliku do odczytu.

Zwraca

String

String zawierającej zawartość pliku.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\); kończy się ukośnikiem.

ArgumentNullException

Parametr file ma wartość Nothing.

FileNotFoundException

Plik nie istnieje.

IOException

Plik jest używany przez inny proces lub występuje błąd we/wy.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

OutOfMemoryException

Za mało pamięci, aby zapisać ciąg do buforu.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

Przykłady

Ten przykład odczytuje zawartość Test.txt ciągu, a następnie wyświetla ją w polu komunikatu.

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

W tym przykładzie zawartość pliku Test.txt ASCII jest odczytywana w ciągu, a następnie wyświetla ją w polu komunikatu.

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

Uwagi

ReadAllText Metoda My.Computer.FileSystem obiektu umożliwia odczytywanie z pliku tekstowego. Zawartość pliku jest zwracana jako ciąg.

Kodowanie pliku można określić, jeśli zawartość pliku jest w kodowaniu, takim jak ASCII lub UTF-8. Jeśli odczytujesz z pliku z rozszerzonymi znakami, musisz określić kodowanie pliku przy użyciu innego przeciążenia ReadAllText metody.

Nie należy podejmować decyzji dotyczących zawartości pliku na podstawie nazwy pliku. Na przykład plik Form1.vb może nie być plikiem źródłowym języka Visual Basic. Przed użyciem danych w aplikacji sprawdź wszystkie dane wejściowe.

W poniższej tabeli wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.ReadAllText .

Do	Zobacz
Odczytywanie z pliku tekstowego	Jak odczytywać z plików tekstowych w Visual Basic

Zobacz też

• Encoding
• ReadAllText
• StreamReader(Stream, Encoding)

ReadAllText(String, Encoding)

Zwraca zawartość pliku tekstowego 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

Nazwa i ścieżka pliku do odczytu.

encoding

Encoding

Kodowanie znaków do użycia w odczytywaniu pliku. Wartość domyślna to UTF-8.

Zwraca

String

String zawierającej zawartość pliku.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\); kończy się ukośnikiem.

ArgumentNullException

Parametr file ma wartość Nothing.

FileNotFoundException

Plik nie istnieje.

IOException

Plik jest używany przez inny proces lub występuje błąd we/wy.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

OutOfMemoryException

Za mało pamięci, aby zapisać ciąg do buforu.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

Przykłady

Ten przykład odczytuje zawartość Test.txt ciągu, a następnie wyświetla ją w polu komunikatu.

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

W tym przykładzie zawartość pliku Test.txt ASCII jest odczytywana w ciągu, a następnie wyświetla ją w polu komunikatu.

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

Uwagi

ReadAllText Metoda My.Computer.FileSystem obiektu umożliwia odczytywanie z pliku tekstowego. Zawartość pliku jest zwracana jako ciąg.

Kodowanie pliku można określić, jeśli zawartość pliku jest w kodowaniu, takim jak ASCII lub UTF-8. Jeśli odczytujesz z pliku z rozszerzonymi znakami, musisz określić kodowanie pliku.

Nie należy podejmować decyzji dotyczących zawartości pliku na podstawie nazwy pliku. Na przykład plik Form1.vb może nie być plikiem źródłowym języka Visual Basic. Przed użyciem danych w aplikacji sprawdź wszystkie dane wejściowe.

W poniższej tabeli wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.ReadAllText .

Do	Zobacz
Odczytywanie z pliku tekstowego	Jak odczytywać z plików tekstowych w Visual Basic

Zobacz też

• Encoding
• StreamReader(Stream, Encoding)