TextFieldParser Kelas

Definisi

Menyediakan metode dan properti untuk mem-parsing file teks terstruktur.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
Warisan
TextFieldParser
Penerapan

Contoh

Contoh ini menguraikan melalui file teks yang dibatasi tab, Bigfile.

Using MyReader As New Microsoft.VisualBasic.FileIO.
    TextFieldParser("c:\logs\bigfile")

    MyReader.TextFieldType = 
        Microsoft.VisualBasic.FileIO.FieldType.Delimited
    MyReader.Delimiters = New String() {vbTab}
    Dim currentRow As String()
    'Loop through all of the fields in the file. 
    'If any lines are corrupt, report an error and continue parsing. 
    While Not MyReader.EndOfData
        Try
            currentRow = MyReader.ReadFields()
            ' Include code here to handle the row.
        Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
            MsgBox("Line " & ex.Message & 
            " is invalid.  Skipping")
        End Try
    End While
End Using

Keterangan

Objek TextFieldParser menyediakan metode dan properti untuk mengurai file teks terstruktur. Mengurai file teks dengan mirip dengan iterasi di atas file teks, sementara menggunakan ReadFields metode untuk mengekstrak bidang teks mirip dengan TextFieldParser memisahkan string.

TextFieldParser dapat mengurai dua jenis file: dibatasi atau lebar tetap. Beberapa properti, seperti Delimiters dan HasFieldsEnclosedInQuotes hanya bermakna saat bekerja dengan file yang dibatasi, sementara FieldWidths properti hanya bermakna saat bekerja dengan file lebar tetap.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan objek Microsoft.VisualBasic.FileIO.TextFieldParser.

Untuk Lihat
Membaca dari file teks yang dibatasi Cara: Membaca Dari File Teks Comma-Delimited
Membaca dari file teks lebar tetap Cara: Membaca dari File Teks dengan Lebar Tetap
Membaca dari file teks dengan beberapa format Cara: Membaca Dari File Teks dengan Berbagai Format

Konstruktor

TextFieldParser(Stream)

Menginisialisasi instans baru kelas TextFieldParser.

TextFieldParser(Stream, Encoding)

Menginisialisasi instans baru kelas TextFieldParser.

TextFieldParser(Stream, Encoding, Boolean)

Menginisialisasi instans baru kelas TextFieldParser.

TextFieldParser(Stream, Encoding, Boolean, Boolean)

Menginisialisasi instans baru kelas TextFieldParser.

TextFieldParser(String)

Menginisialisasi instans baru kelas TextFieldParser.

TextFieldParser(String, Encoding)

Menginisialisasi instans baru kelas TextFieldParser.

TextFieldParser(String, Encoding, Boolean)

Menginisialisasi instans baru kelas TextFieldParser.

TextFieldParser(TextReader)

Menginisialisasi instans baru kelas TextFieldParser.

Properti

CommentTokens

Menentukan token komentar. Token komentar adalah string yang, ketika ditempatkan di awal baris, menunjukkan bahwa baris adalah komentar dan harus diabaikan oleh pengurai.

Delimiters

Menentukan pemisah untuk file teks.

EndOfData

Mengembalikan True jika tidak ada baris non-kosong dan tidak berkomentar antara posisi kursor saat ini dan akhir file.

ErrorLine

Mengembalikan baris yang menyebabkan pengecualian terbaru MalformedLineException .

ErrorLineNumber

Mengembalikan jumlah baris yang menyebabkan pengecualian terbaru MalformedLineException .

FieldWidths

Menunjukkan lebar setiap kolom dalam file teks yang sedang diurai.

HasFieldsEnclosedInQuotes

Menunjukkan apakah bidang diapit dalam tanda kutip saat file yang dibatasi sedang diurai.

LineNumber

Mengembalikan nomor baris saat ini, atau mengembalikan -1 jika tidak ada lagi karakter yang tersedia di aliran.

TextFieldType

Menunjukkan apakah file yang akan diurai dibatasi atau lebar tetap.

TrimWhiteSpace

Menunjukkan apakah spasi putih di depan dan di belakang harus dipangkas dari nilai bidang.

Metode

Close()

Menutup objek saat ini TextFieldParser .

Dispose()

Melepaskan sumber daya yang TextFieldParser digunakan oleh objek .

Dispose(Boolean)

Melepaskan sumber daya yang TextFieldParser digunakan oleh objek .

Equals(Object)

Menentukan apakah objek yang ditentukan sama dengan objek saat ini.

(Diperoleh dari Object)
Finalize()

TextFieldParser Memungkinkan objek untuk mencoba membebaskan sumber daya dan melakukan operasi pembersihan lainnya sebelum diklaim kembali oleh pengumpulan sampah.

GetHashCode()

Berfungsi sebagai fungsi hash default.

(Diperoleh dari Object)
GetType()

Mendapatkan instans Type saat ini.

(Diperoleh dari Object)
MemberwiseClone()

Membuat salinan dangkal dari yang saat ini Object.

(Diperoleh dari Object)
PeekChars(Int32)

Membaca jumlah karakter yang ditentukan tanpa memajukan kursor.

ReadFields()

Membaca semua bidang pada baris saat ini, mengembalikannya sebagai array string, dan memajukan kursor ke baris berikutnya yang berisi data.

ReadLine()

Mengembalikan baris saat ini sebagai string dan memajukan kursor ke baris berikutnya.

ReadToEnd()

Membaca sisa file teks dan mengembalikannya sebagai string.

SetDelimiters(String[])

Mengatur pemisah untuk pembaca ke nilai yang ditentukan, dan mengatur jenis bidang ke Delimited.

SetFieldWidths(Int32[])

Mengatur pemisah untuk pembaca ke nilai yang ditentukan.

ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

IDisposable.Dispose()

Melepaskan sumber daya yang TextFieldParser digunakan oleh objek .

Berlaku untuk

Lihat juga