TextFieldParser Klasa

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic.FileIO

Zestaw:: Microsoft.VisualBasic.Core.dll

Zestaw:: Microsoft.VisualBasic.dll

Źródło:: TextFieldParser.vb

Źródło:: TextFieldParser.vb

Źródło:: TextFieldParser.vb

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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: Object
TextFieldParser

Implementuje: IDisposable

Przykłady

W tym przykładzie analizuje się za pomocą pliku tekstowego rozdzielanego 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 elementem TextFieldParser jest podobne do iterowania pliku tekstowego, podczas gdy użycie ReadFields metody wyodrębniania pól tekstu jest podobne do dzielenia ciągów.

Może TextFieldParser przeanalizować dwa typy plików: rozdzielane lub 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
Odczyt 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)	Inicjuje nowe wystąpienie klasy `TextFieldParser`.
TextFieldParser(Stream, Encoding)	Inicjuje nowe wystąpienie klasy `TextFieldParser`.
TextFieldParser(Stream, Encoding, Boolean)	Inicjuje nowe wystąpienie klasy `TextFieldParser`.
TextFieldParser(Stream, Encoding, Boolean, Boolean)	Inicjuje nowe wystąpienie klasy `TextFieldParser`.
TextFieldParser(String)	Inicjuje nowe wystąpienie klasy `TextFieldParser`.
TextFieldParser(String, Encoding)	Inicjuje nowe wystąpienie klasy `TextFieldParser`.
TextFieldParser(String, Encoding, Boolean)	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 nie ma pustych, niepustych wierszy komentarza między bieżącym położeniem kursora a końcem pliku.
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 pliku tekstowym, który jest analizowany.
HasFieldsEnclosedInQuotes	Określa, czy pola są ujęte w cudzysłów, gdy plik rozdzielany jest analizowany.
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 być analizowany, jest rozdzielany, czy stałą szerokością.
TrimWhiteSpace	Wskazuje, czy z wartości pól powinny zostać przycięte wiodące i końcowe białe odstępy.

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 próbę zwolnienia zasobów i wykonanie innych operacji oczyszczania przed odzyskaniem przez odzyskiwanie pamięci.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (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 przesuwa kursor do następnego wiersza zawierającego dane.
ReadLine()	Zwraca bieżący wiersz jako ciąg i przesuwa 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