Метод 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(). Значения ширины полей. Обязательный параметр.

Возвращаемое значение

TextFieldParser

Исключения

При следующих условиях возможно возникновение исключения:

• Путь является недопустимым по одной из следующих причин: строка имеет нулевую длину; строка содержит только пробел; строка содержит недопустимые символы; строка является путем устройства (начинается с \\.\) (ArgumentException).

• Имя файла заканчивается косой чертой (ArgumentException).

• Путь является недопустимым, поскольку он равен Nothing (ArgumentNullException).

• Указанный файл не существует (FileNotFoundException).

• Указанный файл уже используется (IOException).

• Длина пути превышает максимальную длину, определенную в системе (PathTooLongException).

• Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат (NotSupportedException).

• У пользователя нет необходимых разрешений для просмотра пути (SecurityException).

• Строка не может быть проанализирована с использованием указанного формата (MalformedLineException). Сообщение исключения указывает строку, вызвавшую исключение, а в Свойство TextFieldParser.ErrorLine находится текст, содержащийся в строке.

• Пользователь не имеет необходимых разрешений для доступа к файлу (UnauthorizedAccessException).

Задачи

В следующей таблице приведены примеры задач, в которых используется метод My.Computer.FileSystem.OpenTextFieldParser.

Пример

В этом примере объект 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)

Доступность по типу проекта

Разрешения

Могут потребоваться следующие разрешения:

Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.

См. также

Задачи

Практическое руководство. Чтение из текстового файла в Visual Basic

Практическое руководство. Чтение из текстовых файлов с разделителями-запятыми в Visual Basic

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

Основные понятия

Анализ текстовых файлов с помощью объекта TextFieldParser

Ссылки

Объект My.Computer.FileSystem

Объект TextFieldParser

OpenTextFieldParser

Другие ресурсы

Чтение из файлов в Visual Basic