TextFieldParser.PeekChars(Int32) Método

Definição

Namespace:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Origem:

TextFieldParser.vb

Lê o número especificado de caracteres sem avançar o cursor.

public:
 System::String ^ PeekChars(int numberOfChars);

public string? PeekChars (int numberOfChars);

member this.PeekChars : int -> string

Public Function PeekChars (numberOfChars As Integer) As String

Parâmetros

numberOfChars

Int32

O número de caracteres a serem lidos. Obrigatórios.

Retornos

String

Uma cadeia de caracteres que contém o número especificado de caracteres lidos.

Exceções

ArgumentException

numberOfChars é menor que 0.

Exemplos

Este exemplo usa PeekChars para localizar o final dos dados e parar de analisar o arquivo nesse ponto.

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

Comentários

O numberOfChars valor deve ser menor que o número total de caracteres na linha. Se não for, a cadeia de caracteres retornada por PeekChars será truncada até o comprimento da linha.

Linhas em branco são ignoradas.

Os caracteres de fim de linha não são retornados.

O PeekChars método não executa nenhuma análise; um caractere de fim de linha dentro de um campo delimitado é interpretado como o final real da linha.

A tabela a seguir lista exemplos de tarefas que envolvem o PeekChars método .

Para	Consulte
Determinar o formato de um campo antes de analisá-lo	Como: ler de arquivos de texto com vários formatos

Confira também

• OpenTextFieldParser(String)
• Objetos (Visual Basic)
• Analisando arquivos de texto com o objeto TextFieldParser
• Lendo a partir de arquivos no Visual Basic