Método TextFieldParser.PeekChars.

Artigo
08/25/2010

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

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

Parâmetros

numberOfChars
Int32.Número de caracteres a serem lidos.Obrigatório.

Valor de retorno

String.

Exceções

A seguinte condição pode fazer com que uma exceção seja lançada:

numberOfChars é menor que 0)ArgumentException).

Comentários

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

Linhas em branco são ignoradas.

Caracteres de fim-de-linha não são retornados.

O método PeekCharsnão executa análises; um caractere de fim-de-linha dentro de um campo delimitado é interpretado como o próprio fim da linha.

Tarefas

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

Para	Consulte
Determine o formato de um campo antes de analisá-lo.	Como: Leitura de arquivos de texto com Múltiplo formatos no Visual Basic

Exemplo

Este exemplo usa PeekChars para achar o fim dos dados e parar de analisar o arquivo naquele 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

Requisitos

Namespace:Microsoft.VisualBasic.FileIO

Classe:TextFieldParser

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Permissões

As seguintes permissões são necessárias:

Permissão	Descrição
FileIOPermission	Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.
SecurityPermission	Descreve uma série de permissões de seguranças aplicadas ao código.Enumeração associada: ControlEvidence.

Para obter mais informações, consulte Segurança de Acesso de código e Solicitando permissões.

Consulte também