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)。
例外狀況
例外狀況類型 |
錯誤代碼 |
條件 |
---|---|---|
FileNumber 不存在。 |
||
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 中將文字寫入檔案