TextFieldParser Klasa

Definicja

Przestrzeń nazw:: Microsoft.VisualBasic.FileIO

Zestaw:: Microsoft.VisualBasic.dll

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

Ten przykład analizuje 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 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.

Może TextFieldParser przeanalizować dwa typy plików: rozdzielane lub o stałej szerokości. Niektóre właściwości, takie jak Delimiters i HasFieldsEnclosedInQuotes są istotne 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 obiekt Microsoft.VisualBasic.FileIO.TextFieldParser.

Do	Zobacz
Odczytywanie z rozdzielanego pliku tekstowego	Instrukcje: odczytywanie z plików tekstowych Comma-Delimited
Odczyt z pliku tekstowego o stałej szerokości	Instrukcje: odczytywanie z plików tekstowych o stałej szerokości
Odczytywanie z pliku tekstowego z wieloma formatami	Instrukcje: odczytywanie z plików tekstowych z wieloma formatami

Konstruktory

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

Nazwa	Opis
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żącą liczbę wierszy lub zwraca -1, jeśli w strumieniu nie są dostępne żadne znaki.
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 zostać przycięte z wartości pól.

Metody

Nazwa	Opis
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()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (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)

Dotyczy

Zobacz też

Opinia

Czy ta strona była pomocna?