TextFieldParser.ReadFields Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Считывает все поля в текущей строке, возвращает их в виде массива строк и перемещает курсор на следующую строку, содержащую данные.
public:
cli::array <System::String ^> ^ ReadFields();
public string[]? ReadFields ();
public string[] ReadFields ();
member this.ReadFields : unit -> string[]
Public Function ReadFields () As String()
Возвращаемое значение
Массив строк, который содержит значения полей для текущей строки.
Исключения
Невозможно выполнить синтаксический анализ поля с помощью указанного формата.
Примеры
В этом примере метод используется ReadFields для чтения из файла ParserText.txtс разделителями-запятыми . В примере поля записываются Testfile.txtв .
Using MyReader As New Microsoft.VisualBasic.FileIO.TextFieldParser("C:\ParserText.txt")
MyReader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
MyReader.Delimiters = New String() {","}
Dim currentRow As String()
While Not MyReader.EndOfData
Try
currentRow = MyReader.ReadFields()
For Each currentField As String In currentRow
My.Computer.FileSystem.WriteAllText(
"C://testfile.txt", currentField, True)
Next
Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
MsgBox("Line " & ex.Message & " is invalid. Skipping")
End Try
End While
End Using
Комментарии
Чтобы разрешить пользователям анализировать текстовые файлы в нескольких форматах, ReadFields метод проверяет значения TextFieldType, Delimitersи FieldWidths, если они указаны, при каждом вызове. Пользователям необходимо правильно настроить TextFieldType свойства и FieldWidths или Delimiters соответствующим образом. Если TextFieldType для задано значение Delimited, а Delimiters не задано, или если TextFieldType задано значение FixedWidth и FieldWidths, возникает исключение.
При ReadFields обнаружении пустых строк они пропускаются и возвращается следующая непустая строка.
ReadFields Если метод не может проанализировать текущую строку, он вызывает исключение и не переходит к следующей строке. Это позволит приложению повторить синтаксический анализ строки.
В следующей таблице перечислены примеры задач, связанных с методом ReadFields .
| Кому | См. |
|---|---|
| Чтение из файла с разделителями | Практическое руководство. Чтение из текстовых файлов с разделителями-запятыми |
| Чтение из файла фиксированной ширины | Практическое руководство. Чтение из текстовых файлов с полями фиксированного размера |
Применяется к
См. также раздел
- OpenTextFieldParser(String)
- TextFieldType
- FieldWidths
- Delimiters
- ReadLine()
- Объекты (Visual Basic)
- Практическое руководство. Чтение из текстового файла Comma-Delimited в Visual Basic
- Практическое руководство. Чтение из текстового файла фиксированной ширины в Visual Basic
- Практическое руководство. Чтение из текстового файла в нескольких форматах в Visual Basic
- Анализ текстовых файлов с помощью объекта TextFieldParser