TextFieldParser.ReadFields メソッド

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

TextFieldParser.ReadFields メソッド

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

現在行のすべてのフィールドを読み込んで文字列の配列として返し、次のデータが格納されている行にカーソルを進めます。

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

Visual Basic (宣言)

Public Function ReadFields As
 String()

Visual Basic (使用法)

Dim instance As TextFieldParser
Dim returnValue As String()

returnValue = instance.ReadFields

C#

public string[] ReadFields ()

C++

public:
array<String^>^ ReadFields ()

J#

public String[] ReadFields ()

JScript

public function ReadFields () : String[]

戻り値
String ().

解説

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

複数の形式のテキスト ファイルを解析できるようにするため、ReadFields メソッドでは、TextFieldType、Delimiters、および FieldWidths の値が指定されている場合、メソッドを呼び出すたびに、これらの値がチェックされます。TextFieldType プロパティを設定し、さらに、FieldWidths プロパティまたはDelimiters プロパティを適切に設定する必要があります。TextFieldType が Delimited に設定されているにもかかわらず Delimiters を設定しなかった場合、または、TextFieldType を FixedWidth に設定しているにもかかわらず FieldWidths を設定しなかった場合は、例外がスローされます。

ReadFields で空白行が見つかった場合、その行はスキップされ、次の空白以外の行が返されます。

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

目的	参照項目
区切り形式のファイルから読み込む。	方法 : Visual Basic でコンマ区切りのテキスト ファイルを読み取る
固定幅のファイルから読み込む。	方法 : Visual Basic で固定幅のテキスト ファイルを読み取る

使用例

この例では、ReadFields メソッドを使用してファイル ParserText.txt を読み込み、フィールドを Testfile.txt に書き込みます。

Visual Basic

Using MyReader As New Microsoft.VisualBasic.FileIO.TextFieldParser("C:\ParserText.txt")
    MyReader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
    MyReader.Delimiters = New String() {"
,"}
    Dim currentRow As String()
    While Not MyReader.EndOfData
        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 名前空間
TextFieldParser.ReadFields
その他の技術情報
TextFieldParser.ReadFields メソッド
TextFieldParser オブジェクト
TextFieldParser.TextFieldType プロパティ
TextFieldParser.FieldWidths プロパティ
TextFieldParser.Delimiters プロパティ
方法 : Visual Basic でコンマ区切りのテキスト ファイルを読み取る
方法 : Visual Basic で固定幅のテキスト ファイルを読み取る
方法 : Visual Basic で複数の書式を持つテキスト ファイルを読み取る
TextFieldParser オブジェクトによるテキスト ファイルの解析
TextFieldParser.ReadLine メソッド