TextFieldParser.PeekChars メソッド

.NET Framework クラス ライブラリ リファレンス

TextFieldParser.PeekChars メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

カーソルを進めずに、指定された文字数を読み込みます。

名前空間: Microsoft.VisualBasic.FileIO
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Function PeekChars ( _
    numberOfChars As Integer _
) As String

Visual Basic (使用法)

Dim instance As TextFieldParser
Dim numberOfChars As Integer
Dim returnValue As String

returnValue = instance.PeekChars(numberOfChars)

C#

public string PeekChars (
    int numberOfChars
)

C++

public:
String^ PeekChars (
    int numberOfChars
)

J#

public String PeekChars (
    int numberOfChars
)

JScript

public function PeekChars (
    numberOfChars : int
) : String

パラメータ

numberOfChars

Int32。読み込む文字数。必須。

戻り値
String.

解説

詳細については、Visual Basic のトピック「TextFieldParser.PeekChars メソッド」を参照してください。

numberOfChars 値には、行全体の文字数より小さい値を指定する必要があります。それ以外の場合、PeekChars によって、返される文字列が行の長さに切り詰められます。

空白行は無視されます。

行末文字は返されません。

PeekChars メソッドでは解析処理は行われません。区切りフィールド内の行末文字は実際の行末として解釈されます。

PeekChars メソッドを使ったタスクの例を次の表に示します。

目的	参照項目
解析前にフィールドの形式を判断する。	方法 : Visual Basic で複数の書式を持つテキスト ファイルを読み取る

使用例

この例では、PeekChars を使用して、データの終端位置を検索し、その位置まで到達したらファイルの解析を終了します。

Visual Basic

Using MyReader As New Microsoft.VisualBasic.FileIO.TextFieldParser("C:\ParserText.txt")
    MyReader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
    MyReader.Delimiters = New String() {"
,"}
    MyReader.CommentTokens = New String() {"'"}
    Dim currentRow As String()
    While (MyReader.PeekChars(1) IsNot "")
        Try
            currentRow = MyReader.ReadFields()
            For Each currentField As
 String In currentRow
                My.Computer.FileSystem.WriteAllText _
               ("C://testfile.txt", currentField,
 True)
            Next
        Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
            MsgBox("Line " & ex.Message &
 " is invalid.  Skipping")
        End Try
    End While
End Using

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TextFieldParser クラス
TextFieldParser メンバ
Microsoft.VisualBasic.FileIO 名前空間
PeekChars
その他の技術情報
TextFieldParser.PeekChars メソッド
TextFieldParser オブジェクト
TextFieldParser オブジェクトによるテキスト ファイルの解析
Visual Basic でのファイルの読み取り