TextFieldParser Класс

Определение

Пространство имен:: Microsoft.VisualBasic.FileIO

Сборка:: Microsoft.VisualBasic.Core.dll

Сборка:: Microsoft.VisualBasic.dll

Исходный код:: TextFieldParser.vb

Исходный код:: TextFieldParser.vb

Исходный код:: TextFieldParser.vb

Исходный код:: TextFieldParser.vb

Исходный код:: TextFieldParser.vb

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

public ref class TextFieldParser : IDisposable

public class TextFieldParser : IDisposable

type TextFieldParser = class
    interface IDisposable

Public Class TextFieldParser
Implements IDisposable

Наследование: Object
TextFieldParser

Реализации: IDisposable

Примеры

В этом примере анализируется текстовый файл с разделителями табуляции. 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

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

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

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

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

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

Имя	Описание
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)

Явные реализации интерфейса

Имя	Описание
IDisposable.Dispose()	Освобождает ресурсы, используемые TextFieldParser объектом.

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

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

Обратная связь

Были ли сведения на этой странице полезными?