TextFieldParser.PeekChars (Método)

Artículo
10/07/2008

Actualización: noviembre 2007

Lee el número de caracteres especificado sin avanzar el 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 que leer. Obligatorio.

Valor devuelto

String.

Excepciones

La condición siguiente puede hacer que se produzca una excepción:

numberOfChars es menor que 0 (ArgumentException).

Comentarios

El valor numberOfChars debe ser menor que el número total de caracteres de la línea. Si no lo es, la cadena devuelta PeekChars se truncará a la longitud de la línea.

Las líneas en blanco se omiten.

No se devuelven los caracteres de fin de línea.

El método PeekChars no realiza ningún análisis; un carácter de fin de línea contenido en un campo delimitado se interpreta como el fin de línea real.

Tareas

La tabla siguiente muestra una lista de ejemplos de tareas en las que está implicado el método PeekChars.

Para	Vea
Determinar el formato de un campo antes de analizarlo	Cómo: Leer archivos de texto con varios formatos en Visual Basic

Ejemplo

Este ejemplo utiliza PeekChars para buscar el final de los datos y detener el análisis del archivo en ese punto.

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

Espacio de nombres:Microsoft.VisualBasic.FileIO

Clase:TextFieldParser

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Permisos

Se requieren los siguientes permisos:

Permiso	Descripción
FileIOPermission	Controla la capacidad de tener acceso a archivos y carpetas. Enumeración asociada: Unrestricted.
SecurityPermission	Describe un conjunto de permisos de seguridad aplicados al código. Enumeración asociada: ControlEvidence.

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Compartir a través de