My.Computer.FileSystem.ReadAllText 方法
更新：2007 年 11 月
以 String 傳回文字檔的內容。
' Usage Dim value As String = My.Computer.FileSystem.ReadAllText(file) Dim value As String = My.Computer.FileSystem.ReadAllText(file ,encoding) ' Declaration Public Function ReadAllText( _ ByVal file As String _ ) As String ' -or- Public Function ReadAllText( _ ByVal file As String, _ ByVal encoding As System.Text.Encoding _ ) As String
參數
file
String。要讀取之檔案的名稱和路徑。必要項。encoding
System.Text.Encoding。此為讀取檔案時所要使用的字元編碼方式。必要項。預設值為 UTF-8。
傳回值
包含檔案內容的 String。
例外狀況
檔案內容可能與預期不同，並從檔案讀取資料的方法會失敗。
下列情形可能會造成例外狀況：
因下列其中一項原因而導致路徑無效：它是長度為零的字串、它只包含空白字元、它包含無效的字元，或者它是裝置路徑 (開頭為 \\.\) (ArgumentException)。
檔案名稱以斜線結束 (ArgumentException)。
路徑無效，因為它是 Nothing (ArgumentNullException)。
檔案不存在 (FileNotFoundException)。
檔案正由另一個程序使用中，或發生 I/O 錯誤 (IOException)。
路徑超過系統定義的最大長度 (PathTooLongException)。
路徑中的檔案或目錄名稱含有冒號 (:)，或者是無效的格式 (NotSupportedException)。
記憶體不足，無法將字串寫入緩衝區 (OutOfMemoryException)。
使用者缺乏必要的使用權限來檢視路徑 (SecurityException)。
備註
My.Computer.FileSystem 物件的 ReadAllText 方法可讓您讀取文字檔。檔案的內容會以字串傳回。
如果檔案的內容是使用如 ASCII 或 UTF-8 這類的編碼方式，則可以指定檔案編碼方式。如果您要讀取含擴充字元的檔案，就必須指定檔案編碼方式。
不要根據檔案名稱來判斷檔案內容。例如，檔案 Form1.vb 可能不是 Visual Basic 原始程式檔。在應用程式中使用這些資料之前，請先驗證所有輸入值。
工作
下表列出包含 My.Computer.FileSystem.ReadAllText 方法的工作範例。
若要 |
請參閱 |
|---|---|
從文字檔讀取 |
範例
這個範例會讀取 Test.txt 的內容並存成字串，然後在訊息方塊中加以顯示。
Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt")
MsgBox(reader)
這個範例會讀取 ASCII 檔案 Test.txt 的內容並存成字串，然後在訊息方塊中加以顯示。
Dim reader As String
reader = My.Computer.FileSystem.ReadAllText("C:\test.txt", _
System.Text.Encoding.ASCII)
MsgBox(reader)
需求
命名空間 (Namespace)︰Microsoft.VisualBasic.MyServices
類別 (Class)：FileSystemProxy (提供對 FileSystem 的存取)
組件：Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)
依專案類型的可用性
專案類型 |
是否可用 |
|---|---|
Windows 應用程式 |
是 |
類別庫 |
是 |
主控台應用程式 |
是 |
Windows 控制項程式庫 |
是 |
Web 控制項程式庫 |
是 |
Windows 服務 |
是 |
網站 |
是 |
使用權限
下列使用權限可能為必要：
使用權限 |
描述 |
|---|---|
控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。 |
請參閱
工作
HOW TO：以 StreamReader 從檔案讀取文字 (Visual Basic)