Input 函式

發行項
08/21/2008

更新：2007 年 11 月

自開啟的循序檔中讀取資料，並將該資料指派至變數。

Public Sub Input( _
   FileNumber As Integer, _
   ByRef Value As Object _
)

參數

FileNumber
必要項，任何有效的檔案號碼。
Value
必要項，當變數所指派的值是讀自於檔案時，這些變數不可以是陣列或物件變數。

例外狀況

例外狀況類型	錯誤代碼	條件
IOException	52	FileNumber 不存在。
IOException	54	檔案模式無效。

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

備註

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

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

安全性注意事項：
當讀取檔案時，請勿根據副檔名來判斷檔案內容。例如，名稱為 Form1.vb 的檔案未必是 Visual Basic 的原始程式檔。

讀取時，標準字串或數字資料會被指派至變數，而不會進行任何修改。下表說明如何處理其他輸入資料。

資料	指定給變數的值
分隔逗號或空白行	Empty
#NULL#	DBNull
#TRUE# 或 #FALSE#	True 或False
#yyyy-mm-ddhh:mm:ss#	運算式代表的日期和/或時間
#ERROR errornumber#	errornumber (變數是一個標記為錯誤的物件)

如果您在輸入資料項目時抵達檔案結尾，輸入將結束並發生錯誤。

注意事項：
Input 函式並未當地語系化。例如，在德文版中，會將逗號視為變數分隔符號，而非小數點，因此如果輸入 3,14159，將只會傳回 3。

安全性注意事項：
以 Input 函式讀取檔案時，需要 FileIOPermissionAccess 列舉型別中的 Read 存取權。如需詳細資訊，請參閱 FileIOPermissionAccess 列舉型別。

範例

這個範例使用 Input 函式，將檔案中的資料讀取到兩個變數中。這個範例假設 TestFile 是內含幾行使用 Write 函式寫入資料的檔案，每行都包含在引號內的字串及以逗號分隔的數字，例如，("Hello", 234)。

FileOpen(1, "TESTFILE", OpenMode.Output)
Write(1, "hello")
Write(1, 14)
FileClose(1)
Dim s As String = "teststring"
Dim i As Integer 
FileOpen(1, "TESTFILE", OpenMode.Input)
Input(1, s)
MsgBox(s)
Input(1, i)
MsgBox(i)
FileClose(1)

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

不支援這個函式。

需求

命名空間 (Namespace)︰Microsoft.VisualBasic

**模組︰**FileSystem

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

請參閱

共用方式為

Input 函式

參數

例外狀況

備註

範例

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

需求

請參閱

工作

參考

其他資源

其他資源