FileSystem.ReadAllText 方法

定義

命名空間:

Microsoft.VisualBasic.FileIO

組件:

Microsoft.VisualBasic.Core.dll

以 String 傳回文字檔內容。

多載

ReadAllText(String)	以 String 傳回文字檔內容。
ReadAllText(String, Encoding)	以 String 傳回文字檔內容。

ReadAllText(String)

來源:

FileSystem.vb

以 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

參數

file

String

要讀取之檔案的名稱和路徑。

傳回

String

String，其中包含檔案內容。

例外狀況

ArgumentException

路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為斜線。

ArgumentNullException

file 為 Nothing。

FileNotFoundException

檔案不存在。

IOException

檔案正由另一個程序使用中，或發生 I/O 錯誤。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

OutOfMemoryException

沒有足夠的記憶體可將字串寫入緩衝區。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

範例

本範例會將 的內容 Test.txt 讀入字串，然後將它顯示在消息框中。

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

本範例會將 ASCII 檔案 Test.txt 的內容讀入字串，然後將它顯示在消息框中。

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

備註

ReadAllText 物件的 My.Computer.FileSystem 方法允許您從文字檔讀取。 檔案的內容會以字串的形式傳回。

如果檔案的內容是 ASCII 或 UTF-8 編碼，則可以指定檔案編碼。 如果您要從具有擴充字元的 ReadAllText 檔案讀取，則必須使用 方法的另一個多載來指定檔案編碼。

請勿根據檔案名稱來判斷檔案內容。 例如，檔案 Form1.vb 可能不是 Visual Basic 來源檔案。 在應用程式中使用這些資料之前，請先驗證所有輸入值。

下表列出涉及 My.Computer.FileSystem.ReadAllText 方法的工作範例。

收件者	請參閱
從文字檔讀取	如何：在 Visual Basic 中從文字檔讀取

另請參閱

• Encoding
• ReadAllText
• StreamReader(Stream, Encoding)

ReadAllText(String, Encoding)

來源:

FileSystem.vb

以 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

參數

file

String

要讀取之檔案的名稱和路徑。

encoding

Encoding

讀取檔案時使用的字元編碼方式。 預設值為 UTF-8。

傳回

String

String，其中包含檔案內容。

例外狀況

ArgumentException

路徑無效，原因如下：它是長度為零的字串;它只包含空格符;它包含無效的字元;或它是裝置路徑， (開頭為 \\.\) ;結尾為斜線。

ArgumentNullException

file 為 Nothing。

FileNotFoundException

檔案不存在。

IOException

檔案正由另一個程序使用中，或發生 I/O 錯誤。

PathTooLongException

路徑超過系統定義的最大長度。

NotSupportedException

路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式。

OutOfMemoryException

沒有足夠的記憶體可將字串寫入緩衝區。

SecurityException

使用者缺乏必要的使用權限來檢視路徑。

範例

本範例會將 的內容 Test.txt 讀入字串，然後將它顯示在消息框中。

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

本範例會將 ASCII 檔案 Test.txt 的內容讀入字串，然後將它顯示在消息框中。

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

備註

ReadAllText 物件的 My.Computer.FileSystem 方法允許您從文字檔讀取。 檔案的內容會以字串的形式傳回。

如果檔案的內容是 ASCII 或 UTF-8 編碼，則可以指定檔案編碼。 如果您要從具有擴充字元的檔案讀取，則需要指定檔案編碼方式。

請勿根據檔案名稱來判斷檔案內容。 例如，檔案 Form1.vb 可能不是 Visual Basic 來源檔案。 在應用程式中使用這些資料之前，請先驗證所有輸入值。

下表列出涉及 My.Computer.FileSystem.ReadAllText 方法的工作範例。

收件者	請參閱
從文字檔讀取	如何：在 Visual Basic 中從文字檔讀取

另請參閱

• Encoding
• StreamReader(Stream, Encoding)