TextFieldParser Класс

Определение

Пространство имен:

Microsoft.VisualBasic.FileIO

Сборка:

Microsoft.VisualBasic.Core.dll

Исходный код:

TextFieldParser.vb

Предоставляет методы и свойства для анализа структурированных текстовых файлов.

C#

public class TextFieldParser : IDisposable

Наследование

Object

TextFieldParser

Реализации

IDisposable

Примеры

В этом примере выполняется анализ текстового файла с разделителями табуляции Bigfile.

VB

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

Комментарии

Объект TextFieldParser предоставляет методы и свойства для анализа структурированных текстовых файлов. Синтаксический анализ текстового файла с TextFieldParser помощью аналогично итерации по текстовому файлу, а использование ReadFields метода для извлечения полей текста аналогично разделу строк.

может TextFieldParser анализировать файлы двух типов: с разделителями или с фиксированной шириной. Некоторые свойства, такие как Delimiters и HasFieldsEnclosedInQuotes , имеют смысл только при работе с файлами с разделителями, а FieldWidths свойство имеет смысл только при работе с файлами фиксированной ширины.

В следующей таблице перечислены примеры задач, связанных с Microsoft.VisualBasic.FileIO.TextFieldParser объектом .

Кому	См.
Чтение из текстового файла с разделителями	Практическое руководство. Чтение из текстовых файлов с разделителями-запятыми
Чтение из текстового файла фиксированной ширины	Практическое руководство. Чтение из текстовых файлов с полями фиксированного размера
Чтение из текстового файла в нескольких форматах	Практическое руководство. Чтение из текстовых файлов различных форматов

Конструкторы

TextFieldParser(Stream, Encoding, Boolean, Boolean)	Инициализирует новый экземпляр класса TextFieldParser.
TextFieldParser(Stream, Encoding, Boolean)	Инициализирует новый экземпляр класса TextFieldParser.
TextFieldParser(Stream, Encoding)	Инициализирует новый экземпляр класса TextFieldParser.
TextFieldParser(Stream)	Инициализирует новый экземпляр класса TextFieldParser.
TextFieldParser(String, Encoding, Boolean)	Инициализирует новый экземпляр класса TextFieldParser.
TextFieldParser(String, Encoding)	Инициализирует новый экземпляр класса TextFieldParser.
TextFieldParser(String)	Инициализирует новый экземпляр класса TextFieldParser.
TextFieldParser(TextReader)	Инициализирует новый экземпляр класса TextFieldParser.

Свойства

CommentTokens	Определяет маркер комментария. Маркер комментария является последовательностью символов, которая при помещении в начале строки указывает, что данная строка является комментарием и не должна обрабатываться средством синтаксического анализа.
Delimiters	Определяет разделители в текстовом файле.
EndOfData	Возвращает True, если между текущей позицией курсора и концом файла нет непустых строк, не являющихся комментариями.
ErrorLine	Возвращает строку, вызвавшую последнее исключение MalformedLineException.
ErrorLineNumber	Возвращает номер строки, вызвавшей последнее исключение MalformedLineException.
FieldWidths	Обозначает ширину каждого столбца в анализируемом текстовом файле.
HasFieldsEnclosedInQuotes	При анализе файла с разделителями обозначает, заключены ли поля в кавычки.
LineNumber	Возвращает номер текущей строки или значение "–1", если в потоке не осталось символов.
TextFieldType	Указывает, является ли анализируемый файл файлом с разделителями или файлом с полями фиксированного размера.
TrimWhiteSpace	Указывает, нужно ли удалять начальные и конечные пробелы из значений поля.

Методы

Close()	Закрывает текущий объект TextFieldParser.
Dispose()	Освобождает ресурсы, используемые объектом TextFieldParser.
Dispose(Boolean)	Освобождает ресурсы, используемые объектом TextFieldParser.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Finalize()	Позволяет объекту TextFieldParser попытаться освободить ресурсы и выполнить другие завершающие операции, прежде чем объект будет уничтожен в процессе сборки мусора.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
PeekChars(Int32)	Считывает указанное число символов, не перемещая курсор.
ReadFields()	Считывает все поля в текущей строке, возвращает их в виде массива строк и перемещает курсор на следующую строку, содержащую данные.
ReadLine()	Возвращает текущую строку в качестве строки и перемещает курсор к следующей строке.
ReadToEnd()	Считывает оставшуюся часть текстового файла и возвращает ее в виде строки.
SetDelimiters(String[])	Задает указанные значения разделителя для чтения и устанавливает типы полей в Delimited.
SetFieldWidths(Int32[])	Задает указанные значения разделителя для чтения.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

Применяется к

См. также раздел

• OpenTextFieldParser(String)
• Объекты (Visual Basic)
• Анализ текстовых файлов с помощью объекта TextFieldParser
• Разрешение вопросов, связанных с исключениями: Microsoft.VisualBasic.FileIO.TextFieldParser.MalformedLineException