Partager via


TextFieldParser.PeekChars, méthode

Mise à jour : novembre 2007

Lit le nombre de caractères spécifié sans avancer le curseur.

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

Paramètres

  • numberOfChars
    Int32. Nombre de caractères à lire. Obligatoire.

Valeur de retour

String.

Exceptions

La condition ci-dessous peut lever une exception :

Notes

La valeur numberOfChars doit être inférieure au nombre total de caractères dans la ligne. Sinon, la chaîne retournée par PeekChars est tronquée à la longueur de la ligne.

Les lignes vides sont ignorées.

Les caractères de fin de ligne ne sont pas retournés.

La méthode PeekChars n'exécute aucune analyse ; un caractère de fin de ligne contenu dans un champ délimité est interprété comme la fin réelle de la ligne.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode PeekChars.

Pour

Consultez

Déterminer le format d'un champ avant de l'analyser

Comment : lire des fichiers texte avec plusieurs formats dans Visual Basic

Exemple

Cet exemple utilise PeekChars pour rechercher la fin des données et arrêter l'analyse du fichier à ce stade.

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

Configuration requise

Espace de noms :Microsoft.VisualBasic.FileIO

Classe :TextFieldParser

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Autorisations

Les autorisations suivantes sont requises :

Autorisation

Description

FileIOPermission

Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted.

SecurityPermission

Décrit un jeu d'autorisations de sécurité appliquées au code. Énumération associée : ControlEvidence.

Pour plus d'informations, consultez Sécurité d'accès du code et Demande d'autorisations.

Voir aussi

Concepts

Analyse des fichiers texte avec l'objet TextFieldParser

Référence

TextFieldParser, objet

PeekChars

Autres ressources

Lecture à partir de fichiers en Visual Basic