Метод My.Computer.FileSystem.OpenTextFieldParser
Обновлен: Ноябрь 2007
Метод OpenTextFieldParser позволяет создать объект Объект TextFieldParser, который помогает просто и эффективно вести синтаксический анализ структурированных текстовых файлов — например, журналов. Объект TextFieldParser может использоваться для чтения и файлов как с разделителями, так и с полями фиксированного размера.
' Usage
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file)
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file ,delimiters)
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file ,fieldWidths)
' Declaration
Public Function OpenTextFieldParser( _
ByVal file As String _
) As TextFieldParser
' -or-
Public Function OpenTextFieldParser( _
ByVal file As String, _
ByVal delimiters As String() _
) As TextFieldParser
' -or-
Public Function OpenTextFieldParser( _
ByVal file As String, _
ByVal fieldWidths As Integer() _
) As TextFieldParser
Параметры
file
String. Файл, который необходимо открыть с помощью TextFieldParser. Обязательный параметр.delimiters
String(). Разделители для полей. Обязательный параметр.fieldWidths
Integer(). Значения ширины полей. Обязательный параметр.
Возвращаемое значение
Исключения
При следующих условиях возможно возникновение исключения:
Путь является недопустимым по одной из следующих причин: строка имеет нулевую длину; строка содержит только пробел; строка содержит недопустимые символы; строка является путем устройства (начинается с \\.\) (ArgumentException).
Имя файла заканчивается косой чертой (ArgumentException).
Путь является недопустимым, поскольку он равен Nothing (ArgumentNullException).
Указанный файл не существует (FileNotFoundException).
Указанный файл уже используется (IOException).
Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).
Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).
У пользователя нет необходимых разрешений для просмотра пути (SecurityException).
Строка не может быть проанализирована с использованием указанного формата (MalformedLineException). Сообщение исключения указывает строку, вызвавшую исключение, а в Свойство TextFieldParser.ErrorLine находится текст, содержащийся в строке.
Пользователь не имеет необходимых разрешений для доступа к файлу (UnauthorizedAccessException).
Задачи
В следующей таблице приведены примеры задач, в которых используется метод My.Computer.FileSystem.OpenTextFieldParser.
Чтобы |
См. |
|---|---|
Прочитать текстовый файл с разделителями |
Практическое руководство. Чтение из текстовых файлов с разделителями-запятыми в Visual Basic |
Прочитать текстовый файл фиксированного размера |
Практическое руководство. Чтение из текстовых файлов с фиксированной шириной полей в Visual Basic |
Прочитать текстовый файл с несколькими форматами |
Практическое руководство. Чтение текстовых файлов различных форматов в Visual Basic |
Пример
В этом примере объект reader типа TextFieldParser создается для чтения данных из файла C:\TestFolder1\Test1.txt.
Dim reader As Microsoft.VisualBasic.FileIO.TextFieldParser
reader = My.Computer.FileSystem.OpenTextFieldParser _
("C:\TestFolder1\test1.txt")
reader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
reader.delimiters = New String() {","}
Dim currentRow As String()
While Not reader.EndOfData
Try
currentRow = reader.ReadFields()
Dim currentField As String
For Each currentField In currentRow
MsgBox(currentField)
Next
Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
MsgBox("Line " & ex.Message & _
"is not valid and will be skipped.")
End Try
End While
Требования
Пространство имен:Microsoft.VisualBasic.MyServices
Класс:FileSystemProxy (предоставляет доступ к FileSystem)
Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)
Доступность по типу проекта
Тип проекта |
Доступность |
|---|---|
Приложение Windows |
Да |
Библиотека классов |
Да |
Консольное приложение |
Да |
Библиотека элементов управления Windows |
Да |
Библиотека веб-элементов управления |
Да |
Служба Windows |
Да |
Веб-узел |
Да |
Разрешения
Могут потребоваться следующие разрешения:
Разрешение |
Описание |
|---|---|
Управляет доступом к файлам и папкам. Связанное перечисление: Unrestricted. |
|
Описывает набор разрешений безопасности, применимых к коду. Связанное перечисление: ControlEvidence. |
Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.
См. также
Задачи
Практическое руководство. Чтение из текстового файла в Visual Basic
Практическое руководство. Чтение из текстовых файлов с разделителями-запятыми в Visual Basic
Практическое руководство. Чтение текстовых файлов различных форматов в Visual Basic
Основные понятия
Анализ текстовых файлов с помощью объекта TextFieldParser