InputString 関数
更新 : 2007 年 11 月
Input モードまたは Binary モードで開いたファイルから読み取る文字を表す文字列型 (String) の値を返します。
My 機能を使用すると、InputString を使用するよりもファイル I/O 処理の生産性とパフォーマンスが格段に向上します。詳細については、「My.Computer.FileSystem オブジェクト」を参照してください。
InputString(_
ByVal FileNumber As Integer, _
ByVal CharCount As Integer _
) As String
パラメータ
FileNumber
必ず指定します。有効なファイル番号です。CharCount
必ず指定します。ファイルから読み取る文字数を指定する有効な数式。
例外
例外の種類 |
エラー番号 |
条件 |
|---|---|---|
FileNumber が存在していません。 |
||
CharCount が 0 より小さいか、または 214 より大きい値です。 |
非構造化エラー処理を使用する Visual Basic 6.0 アプリケーションをアップグレードする場合は、"エラー番号" の列を参照してください(エラー番号を Number プロパティ (Err オブジェクト) と比較することもできます)。ただし、可能であれば、このようなエラー制御は Visual Basic の構造化例外処理の概要 に置き換えることを検討してください。
解説
InputString 関数は、下位互換性を保つために提供されており、パフォーマンスに影響を与える可能性があります。非レガシ アプリケーションに対しては、My.Computer.FileSystem オブジェクトを使用した方が、パフォーマンスが高くなります。詳細については、「Visual Basic におけるファイル アクセス」を参照してください。
通常、InputString 関数を使用して読み込んだデータは Print 関数または FilePut 関数を使用してファイルに書き込みます。この関数は、Input モードまたは Binary モードで開いたファイルに対してだけ使用します。
Input 関数と異なり、InputString 関数は、コンマ、キャリッジ リターン、ライン フィード、二重引用符、および先行空白を含む、読み込んだすべての文字を返します。
Binary モードでファイルを開いた場合、InputString 関数を使用して EOF 関数が True を返すまでファイルを読み込もうとすると、エラーが発生します。InputString 関数を使用してバイナリ ファイルを読み込む場合は、EOF 関数の代わりに LOF 関数および Loc 関数を使用します。EOF 関数を使用する場合は、FileGet を使用してください。
.gif "セキュリティに関するメモ") セキュリティに関するメモ : |
|---|
ファイルからデータを読み取るときは、ファイル名の拡張子に基づいてファイルの内容を判断しないでください。たとえば、Form1.vb という名前のファイルが Visual Basic のソース ファイルとは限りません。 |
使用例
InputString 関数を使って、ファイルから 1 文字ずつ読み込み、読み込んだ文字を 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)
スマート デバイス開発者のためのメモ
この関数はサポートされていません。
必要条件
名前空間 : Microsoft.VisualBasic
モジュール : FileSystem
アセンブリ : Visual Basic ランタイム ライブラリ (Microsoft.VisualBasic.dll)
参照
処理手順
方法 : Visual Basic で StreamWriter を使用してテキストをファイルに書き込む
方法 : Visual Basic でテキストをファイルに書き込む