Share via

InputString 函式

  • 發行項

更新：2007 年 11 月

傳回 String 值，內含以 Input 或 Binary 模式所開啟檔案中的字元。

My 功能在檔案 I/O 作業中的產能和效能勝過 InputString。如需詳細資訊，請參閱 My.Computer.FileSystem 物件。

InputString(_
   ByVal FileNumber As Integer, _
   ByVal CharCount As Integer _
) As String

參數

  • FileNumber
    必要項，任何有效的檔案號碼。

  • CharCount
    必要項，任何指定讀取字元數的有效數值運算式 (Numeric Expression)。

例外狀況

例外狀況類型

錯誤代碼

條件

IOException

52

FileNumber 不存在。

ArgumentException

5

CharCount < 0 或 > 214。

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級，請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是，請盡可能考慮以 Visual Basic 的結構化例外處理概觀 取代這類錯誤控制項。

備註

提供 InputString 函式以取得回溯相容性，但可能會影響效能。對於非舊版應用程式，My.Computer.FileSystem 物件會提供更好的效能。如需詳細資訊，請參閱使用 Visual Basic 存取檔案。

以 InputString 函式讀取的資料通常會以 Print 或 FilePut 寫入檔案。這個函式只能用於以 Input 或 Binary 模式開啟的檔案。

InputString 函式和 Input 函式並不相同，它會傳回所讀取的所有字元，包括逗號、歸位字元 (Carriage Return)、換行字元、引號及前置空格。

對於針對 Binary 存取所開啟的檔案，使用 InputString 函式試圖讀取整個檔案 (直到 EOF 傳回 True 為止) 會產生錯誤。以 InputString 讀取二進位檔案時，請使用 LOF 和 Loc 函式來取代 EOF，或在使用 EOF 函式時使用 FileGet。

安全性注意事項：

當讀取檔案時，請勿根據副檔名來判斷檔案內容。例如，名稱為 Form1.vb 的檔案可能不是 Visual Basic 原始程式檔 (Source File)。

範例

這個範例會使用 InputString 函式自檔案中一次讀取一個字元，並且列印至 Output 視窗中。這個範例假設 MyFile 為內含數行範例資料的文字檔。

Dim oneChar As String
' Open file.
FileOpen(1,  "MYFILE.TXT", OpenMode.Input)
' Loop until end of file.
While Not EOF(1)
' Get one character.
oneChar = (InputString(1, 1))
' Print to the output window.
System.Console.Out.WriteLine(oneChar)
End While
FileClose(1)

智慧型裝置開發人員注意事項

不支援這個函式。

需求

命名空間 (Namespace)︰Microsoft.VisualBasic

**模組︰**FileSystem

組件：Visual Basic Runtime Library (在 Microsoft.VisualBasic.dll 中)

請參閱

工作

HOW TO：在 Visual Basic 中以 StreamWriter 將文字寫入檔案

HOW TO：在 Visual Basic 中將文字寫入檔案

參考

Input 函式

其他資源

使用 Visual Basic 存取檔案