TextFieldParser.PeekChars, méthode

Article
09/12/2008

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 :

numberOfChars est inférieur à 0 (ArgumentException).

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

Partager via