FileSystem.InputString(Int32, Int32) 方法

定義

命名空間:

Microsoft.VisualBasic

組件:

Microsoft.VisualBasic.Core.dll

來源:

FileSystem.vb

傳回 String 值，其中包含於 Input 或 Binary 模式下開啟之檔案中的字元。 相較於 InputString，My 功能可提升檔案 I/O 作業的產能和效能。 如需詳細資訊，請參閱FileSystem。

public:
 static System::String ^ InputString(int FileNumber, int CharCount);

[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("macos")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public static string InputString (int FileNumber, int CharCount);

[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("macos")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
static member InputString : int * int -> string

Public Function InputString (FileNumber As Integer, CharCount As Integer) As String

參數

FileNumber

Int32

必要。 任何有效的檔案數目。

CharCount

Int32

必要。 任何有效的數值運算式，指定要讀取的字元數。

傳回

String

字串，其中包含於 Input 或 Binary 模式下開啟之檔案中的字元。 相較於 InputString，My 功能可提升檔案 I/O 作業的產能和效能。

屬性

UnsupportedOSPlatformAttribute

例外狀況

IOException

FileNumber 不存在。

ArgumentException

CharCount< 0 或 > 214。

範例

本範例會使用 函 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)

備註

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

使用 InputString 函式讀取的數據通常會使用 Print 或 FilePut寫入檔案。 只有在或 Binary 模式中Input開啟的檔案時，才使用此函式。

不同於函 Input 式，函 InputString 式會傳回它讀取的所有字元。 這包括逗號、歸位字元、換行字元、引號和前置空格。

開啟檔案以供 Binary 存取時，會嘗試使用 InputString 函式讀取檔案，直到 EOF 傳回 True 時產生錯誤。 LOF當您使用 InputString讀取二進位檔時，請使用 和 Loc 函式，或使用 FileGetEOF 函式。EOF

注意

從檔案讀取時，請勿根據擴展名來決定檔案內容的安全性決策。 例如，名為 Form1.vb 的檔案可能不是 Visual Basic 原始程式檔。

另請參閱

• Input
• 使用 Visual Basic 存取檔案
• 如何：使用 Streamwriter 將文字寫入檔案， (Visual Basic)
• 如何：在 Visual Basic 中將文字寫入檔案