Udostępnij za pośrednictwem

FileSystemProxy.ReadAllText Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.VisualBasic.MyServices
Zestaw:
Microsoft.VisualBasic.dll
Zestaw:
Microsoft.VisualBasic.Forms.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)

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

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 wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.ReadAllText .

Działanie Zobacz
Odczyt z pliku tekstowego Instrukcje: odczytywanie z plików tekstowych

Zobacz też

Dotyczy

ReadAllText(String, Encoding)

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

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 wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.ReadAllText .

Działanie Zobacz
Odczyt z pliku tekstowego Instrukcje: odczytywanie z plików tekstowych

Zobacz też

Dotyczy