TextFieldParser, objet
Mise à jour : novembre 2007
Fournit des méthodes et des propriétés pour analyser des fichiers texte structurés.
Public Class TextFieldParser
Exceptions
La condition ci-dessous peut générer une exception.
- Un champ de texte ne correspond pas au format spécifié. Par exemple, dans un fichier à largeur fixe; l'un des champs ne correspond pas à la largeur spécifiée. (MalformedLineException).
Notes
L'objet TextFieldParser fournit des méthodes et des propriétés pour analyser des fichiers texte structurés. Analyser un fichier texte avec le TextFieldParser correspond à parcourir un fichier texte, alors que la méthode ReadFields pour extraire des champs de texte correspond à fractionner les chaînes.
Le TextFieldParser peut analyser deux types de fichiers : les fichiers délimités ou les fichiers à largeur fixe. Certaines propriétés, telles que Delimiters et HasFieldsEnclosedInQuotes sont significatives uniquement pour les fichiers délimités, alors que la propriété FieldWidths est significative uniquement pour les fichiers à largeur fixe.
Tâches
Le tableau suivant répertorie des exemples de tâches impliquant l'objet Microsoft.VisualBasic.FileIO.TextFieldParser.
Pour |
Voir |
|---|---|
Lire un fichier texte délimité |
Comment : lire des fichiers texte délimités par des virgules dans Visual Basic |
Lire un fichier texte à largeur fixe |
Comment : lire des fichiers texte de largeur fixe dans Visual Basic |
Lire un fichier texte avec plusieurs formats |
Comment : lire des fichiers texte avec plusieurs formats dans Visual Basic |
Exemple
Cet exemple analyse un fichier texte délimité par des tabulations, Bigfile.
Using MyReader As New Microsoft.VisualBasic.FileIO.TextFieldParser _
("c:\logs\bigfile")
MyReader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
MyReader.Delimiters = New String() {vbTab}
Dim currentRow As String()
'Loop through all of the fields in the file.
'If any lines are corrupt, report an error and continue parsing.
While Not MyReader.EndOfData
Try
currentRow = MyReader.ReadFields()
' Include code here to handle the row.
Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
MsgBox("Line " & ex.Message & _
" is invalid. Skipping")
End Try
End While
End Using
Cet exemple dépend de l'existence d'une fonction, processFields, qui traite les champs au cours de la lecture.
Configuration requise
Espace de noms :Microsoft.VisualBasic.FileIO
Classe :TextFieldParser
**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)
Voir aussi
Tâches
Dépannage des exceptions : Microsoft.VisualBasic.FileIO.TextFieldParser.MalformedLineException
Concepts
Analyse des fichiers texte avec l'objet TextFieldParser
Référence
Membres de l'objet TextFieldParser
TextFieldParser.CommentTokens, propriété
TextFieldParser.Delimiters, propriété
TextFieldParser.EndOfData, propriété
TextFieldParser.ErrorLine, propriété
TextFieldParser.ErrorLineNumber, propriété
TextFieldParser.FieldWidths, propriété
TextFieldParser.HasFieldsEnclosedInQuotes, propriété
TextFieldParser.LineNumber, propriété
TextFieldParser.TextFieldType, propriété
TextFieldParser.TrimWhiteSpace, propriété
TextFieldParser.Close, méthode
TextFieldParser.PeekChars, méthode
TextFieldParser.ReadFields, méthode
TextFieldParser.ReadLine, méthode
TextFieldParser.ReadToEnd, méthode
TextFieldParser.SetDelimiters, méthode
TextFieldParser.SetFieldWidths, méthode