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 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

Udostępnij za pośrednictwem