Метод TextFieldParser.PeekChars

Статья
11/05/2008

Обновлен: Ноябрь 2007

Считывает указанное число знаков без перемещения курсора.

' Usage
Dim value As String = TextFieldParserObject.PeekChars(numberOfChars)
' Declaration
Public Function PeekChars( _
   ByVal numberOfChars As Integer _
) As String

Параметры

numberOfChars
Int32. Количество символов, которые необходимо прочитать. Обязательно.

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

String.

Исключения

Следующее условие может вызвать исключение:

numberOfChars меньше 0 (ArgumentException).

Заметки

Значение numberOfChars должно быть меньше, чем общее число символов в строке. Если это не так, то строка, возвращаемая методом PeekChars будет укорочена до длины строки.

Пустые строки игнорируются.

Символы конца строки не возвращаются.

Метод PeekChars не выполняет синтаксический анализ; символ конца строки в выбранной области интерпретируется как фактический конец строки.

Задачи

В приведенной ниже таблице указаны примеры задач, в которых используется метод PeekChars.

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

Пример

В этом примере для поиска конца данных и прекращения анализа файла в данной точке используется метод PeekChars.

Using MyReader As New Microsoft.VisualBasic.FileIO.TextFieldParser("C:\ParserText.txt")
    MyReader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
    MyReader.Delimiters = New String() {","}
    MyReader.CommentTokens = New String() {"'"}
    Dim currentRow As String()
    While (MyReader.PeekChars(1) IsNot "")
        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

Требования

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

Класс:TextFieldParser

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Разрешения

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

Разрешение	Описание
FileIOPermission	Определяет возможность доступа к файлам и папкам. Связанное перечисление: Unrestricted.
SecurityPermission	Описывает набор разрешений безопасности, примененных к коду. Связанное перечисление: ControlEvidence.

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

См. также

Поделиться через