Udostępnij za pośrednictwem


TextFieldParser Klasa

Definicja

Udostępnia metody i właściwości do analizowania plików tekstowych ze strukturą.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
Dziedziczenie
TextFieldParser
Implementuje

Przykłady

W tym przykładzie analizowany jest plik tekstowy rozdzielany tabulatorami. 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

Uwagi

Obiekt TextFieldParser udostępnia metody i właściwości do analizowania plików tekstowych ze strukturą. Analizowanie pliku tekstowego z TextFieldParser elementem jest podobne do iteracji w pliku tekstowym, podczas gdy użycie ReadFields metody wyodrębniania pól tekstu jest podobne do dzielenia ciągów.

Element TextFieldParser może analizować dwa typy plików: rozdzielane lub o stałej szerokości. Niektóre właściwości, takie jak Delimiters i HasFieldsEnclosedInQuotes , mają znaczenie tylko podczas pracy z plikami rozdzielanymi, podczas gdy FieldWidths właściwość ma znaczenie tylko podczas pracy z plikami o stałej szerokości.

W poniższej tabeli wymieniono przykłady zadań obejmujących Microsoft.VisualBasic.FileIO.TextFieldParser obiekt .

Działanie Zobacz
Odczytywanie z rozdzielanego pliku tekstowego Instrukcje: Odczyt z rozdzielonych przecinkami plików testowych
Odczytywanie z pliku tekstowego o stałej szerokości Instrukcje: Odczyt z plików testowych o stałej szerokości
Odczytywanie z pliku tekstowego z wieloma formatami Instrukcje: Odczyt z plików tekstowych w wielu formatach

Konstruktory

TextFieldParser(Stream, Encoding, Boolean, Boolean)

Inicjuje nowe wystąpienie klasy TextFieldParser.

TextFieldParser(Stream, Encoding, Boolean)

Inicjuje nowe wystąpienie klasy TextFieldParser.

TextFieldParser(Stream, Encoding)

Inicjuje nowe wystąpienie klasy TextFieldParser.

TextFieldParser(Stream)

Inicjuje nowe wystąpienie klasy TextFieldParser.

TextFieldParser(String, Encoding, Boolean)

Inicjuje nowe wystąpienie klasy TextFieldParser.

TextFieldParser(String, Encoding)

Inicjuje nowe wystąpienie klasy TextFieldParser.

TextFieldParser(String)

Inicjuje nowe wystąpienie klasy TextFieldParser.

TextFieldParser(TextReader)

Inicjuje nowe wystąpienie klasy TextFieldParser.

Właściwości

CommentTokens

Definiuje tokeny komentarzy. Token komentarza to ciąg, który po umieszczeniu na początku wiersza wskazuje, że wiersz jest komentarzem i powinien być ignorowany przez analizator.

Delimiters

Definiuje ograniczniki dla pliku tekstowego.

EndOfData

Zwraca wartość True , jeśli między bieżącym położeniem kursora a końcem pliku nie ma żadnych wierszy innych niż puste.

ErrorLine

Zwraca wiersz, który spowodował ostatni MalformedLineException wyjątek.

ErrorLineNumber

Zwraca liczbę wierszy, która spowodowała najnowszy MalformedLineException wyjątek.

FieldWidths

Określa szerokość każdej kolumny w analizowanych plikach tekstowych.

HasFieldsEnclosedInQuotes

Określa, czy pola są ujęte w cudzysłów podczas analizowania pliku rozdzielanego.

LineNumber

Zwraca bieżący numer wiersza lub zwraca wartość -1, jeśli w strumieniu nie ma więcej znaków.

TextFieldType

Wskazuje, czy plik, który ma zostać przeanalizowany, jest rozdzielany, czy o stałej szerokości.

TrimWhiteSpace

Wskazuje, czy białe znaki wiodące i końcowe powinny być przycięte z wartości pól.

Metody

Close()

Zamyka bieżący TextFieldParser obiekt.

Dispose()

Zwalnia zasoby używane przez TextFieldParser obiekt .

Dispose(Boolean)

Zwalnia zasoby używane przez TextFieldParser obiekt .

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
Finalize()

TextFieldParser Umożliwia obiektowi podjęcie próby zwolnienia zasobów i wykonanie innych operacji oczyszczania przed odzyskaniem ich przez odzyskiwanie pamięci.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
PeekChars(Int32)

Odczytuje określoną liczbę znaków bez przechodzenia kursora.

ReadFields()

Odczytuje wszystkie pola w bieżącym wierszu, zwraca je jako tablicę ciągów i przechodzi kursor do następnego wiersza zawierającego dane.

ReadLine()

Zwraca bieżący wiersz jako ciąg i przechodzi kursor do następnego wiersza.

ReadToEnd()

Odczytuje pozostałą część pliku tekstowego i zwraca go jako ciąg.

SetDelimiters(String[])

Ustawia ograniczniki dla czytnika na określone wartości i ustawia typ pola na Delimited.

SetFieldWidths(Int32[])

Ustawia ograniczniki dla czytnika na określone wartości.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Jawne implementacje interfejsu

IDisposable.Dispose()

Zwalnia zasoby używane przez TextFieldParser obiekt .

Dotyczy

Zobacz też