FileSystem.ReadAllText Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.Core.dll

Zwraca zawartość pliku tekstowego jako String.

Przeciążenia

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

ReadAllText(String)

Źródło:

FileSystem.vb

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 odczytania.

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ę końcowym ukośnikiem.

ArgumentNullException

file to 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 do zapisania ciągu do buforu.

SecurityException

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

Przykłady

W tym przykładzie zawartość elementu Test.txt jest odczytywana w ciągu, a następnie jest wyświetlana w oknie 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 jest wyświetlana w oknie 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 znakami rozszerzonymi, 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 rozszerzenia nazwy pliku. Na przykład plik Form1.vb może nie być plikiem źródłowym języka Visual Basic. Sprawdź wszystkie dane wejściowe, zanim użyjesz danych w aplikacji.

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

Działanie	Zobacz
Odczyt z pliku tekstowego	Porady: odczyt z plików testowych w Visual Basic

Zobacz też

• Encoding
• ReadAllText
• StreamReader(Stream, Encoding)

ReadAllText(String, Encoding)

Źródło:

FileSystem.vb

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 odczytania.

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ę końcowym ukośnikiem.

ArgumentNullException

file to 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 do zapisania ciągu do buforu.

SecurityException

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

Przykłady

W tym przykładzie zawartość elementu Test.txt jest odczytywana w ciągu, a następnie jest wyświetlana w oknie 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 jest wyświetlana w oknie 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 znakami rozszerzonymi, musisz określić kodowanie pliku.

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

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

Działanie	Zobacz
Odczyt z pliku tekstowego	Porady: odczyt z plików testowych w Visual Basic

Zobacz też

• Encoding
• StreamReader(Stream, Encoding)