FileSystemProxy.ReadAllText 方法

定義

命名空間:

Microsoft.VisualBasic.MyServices

組件:

Microsoft.VisualBasic.Forms.dll

以 String 傳回文字檔內容。

多載

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

ReadAllText(String)

以 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

參數

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 方法的工作範例。

收件者	請參閱
從文字檔讀取	如何：從文字檔讀取

另請參閱

• Encoding
• ReadAllText(String)
• StreamReader(Stream, Encoding)
• 物件 (Visual Basic)
• 在 Visual Basic 中讀取檔案
• 如何：以 StreamReader 從檔案讀取文字 (Visual Basic)
• 疑難排解：讀取和寫入文字檔
• 逐步解說：在 Visual Basic 中管理檔案和目錄
• 檔案編碼方式

ReadAllText(String, Encoding)

以 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

參數

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 方法的工作範例。

收件者	請參閱
從文字檔讀取	如何：從文字檔讀取

另請參閱

• Encoding
• StreamReader(Stream, Encoding)
• 物件 (Visual Basic)
• 在 Visual Basic 中讀取檔案
• 如何：以 StreamReader 從檔案讀取文字 (Visual Basic)
• 疑難排解：讀取和寫入文字檔
• 逐步解說：在 Visual Basic 中管理檔案和目錄
• 檔案編碼方式