TextFieldParser Klas

Definitie

Naamruimte:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.dll

Biedt methoden en eigenschappen voor het parseren van gestructureerde tekstbestanden.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
Overname
Object
TextFieldParser
Implementeringen
IDisposable

Voorbeelden

In dit voorbeeld wordt een tekstbestand met tabscheidingstekens geparseerd. 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

Opmerkingen

Het TextFieldParser object biedt methoden en eigenschappen voor het parseren van gestructureerde tekstbestanden. Het parseren van een tekstbestand met het TextFieldParser bestand is vergelijkbaar met het herhalen van een tekstbestand, terwijl het ReadFields extraheren van velden met tekst vergelijkbaar is met het splitsen van de tekenreeksen.

De TextFieldParser kan twee typen bestanden parseren: gescheiden of vaste breedte. Sommige eigenschappen, zoals Delimiters en HasFieldsEnclosedInQuotes zijn alleen zinvol wanneer u met bestanden met scheidingstekens werkt, terwijl de FieldWidths eigenschap alleen zinvol is bij het werken met bestanden met vaste breedte.

De volgende tabel bevat voorbeelden van taken met betrekking tot het Microsoft.VisualBasic.FileIO.TextFieldParser-object.

Tot Zien!
Lezen uit een tekstbestand met scheidingstekens Procedure: Lezen uit Comma-Delimited tekstbestanden
Lezen uit een tekstbestand met vaste breedte Procedure: Lezen uit tekstbestanden met vaste breedte
Lezen uit een tekstbestand met meerdere indelingen Procedure: Lezen uit tekstbestanden met meerdere indelingen

Constructors

Name Description
TextFieldParser(Stream, Encoding, Boolean, Boolean)

Initialiseert een nieuw exemplaar van de TextFieldParser klasse.
TextFieldParser(Stream, Encoding, Boolean)

Initialiseert een nieuw exemplaar van de TextFieldParser klasse.
TextFieldParser(Stream, Encoding)

Initialiseert een nieuw exemplaar van de TextFieldParser klasse.
TextFieldParser(Stream)

Initialiseert een nieuw exemplaar van de TextFieldParser klasse.
TextFieldParser(String, Encoding, Boolean)

Initialiseert een nieuw exemplaar van de TextFieldParser klasse.
TextFieldParser(String, Encoding)

Initialiseert een nieuw exemplaar van de TextFieldParser klasse.
TextFieldParser(String)

Initialiseert een nieuw exemplaar van de TextFieldParser klasse.
TextFieldParser(TextReader)

Initialiseert een nieuw exemplaar van de TextFieldParser klasse.

Eigenschappen

Name Description
CommentTokens

Hiermee definieert u opmerkingstokens. Een opmerkingstoken is een tekenreeks die, wanneer deze aan het begin van een regel wordt geplaatst, aangeeft dat de regel een opmerking is en moet worden genegeerd door de parser.
Delimiters

Definieert de scheidingstekens voor een tekstbestand.
EndOfData

Retourneert True als er geen niet-lege, niet-opmerkingenregels zijn tussen de huidige cursorpositie en het einde van het bestand.
ErrorLine

Retourneert de regel die de meest recente MalformedLineException uitzondering heeft veroorzaakt.
ErrorLineNumber

Retourneert het nummer van de regel die de meest recente MalformedLineException uitzondering heeft veroorzaakt.
FieldWidths

Geeft de breedte aan van elke kolom in het tekstbestand dat wordt geparseerd.
HasFieldsEnclosedInQuotes

Geeft aan of velden tussen aanhalingstekens staan wanneer een bestand met scheidingstekens wordt geparseerd.
LineNumber

Retourneert het huidige regelnummer of retourneert -1 als er geen tekens meer beschikbaar zijn in de stream.
TextFieldType

Hiermee wordt aangegeven of het bestand dat moet worden geparseerd, is gescheiden of een vaste breedte heeft.
TrimWhiteSpace

Hiermee wordt aangegeven of voorloop- en volgspaties moeten worden afgekapt van veldwaarden.

Methoden

Name Description
Close()

Hiermee sluit u het huidige TextFieldParser object.
Dispose()

Releases resources die door het TextFieldParser object worden gebruikt.
Dispose(Boolean)

Releases resources die door het TextFieldParser object worden gebruikt.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
Finalize()

Hiermee kan het TextFieldParser object proberen resources vrij te maken en andere opschoonbewerkingen uitvoeren voordat het wordt vrijgemaakt door garbagecollection.
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
PeekChars(Int32)

Hiermee wordt het opgegeven aantal tekens gelezen zonder de cursor door te gaan.
ReadFields()

Leest alle velden op de huidige regel, retourneert ze als een matrix met tekenreeksen en gaat de cursor naar de volgende regel met gegevens.
ReadLine()

Retourneert de huidige regel als een tekenreeks en gaat de cursor naar de volgende regel.
ReadToEnd()

Leest de rest van het tekstbestand en retourneert het als een tekenreeks.
SetDelimiters(String[])

Hiermee stelt u de scheidingstekens voor de lezer in op de opgegeven waarden en stelt u het veldtype in op Delimited.
SetFieldWidths(Int32[])

Hiermee stelt u de scheidingstekens voor de lezer in op de opgegeven waarden.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook