TextFieldParser Classe

Définition

Espace de noms:

Microsoft.VisualBasic.FileIO

Assembly:

Microsoft.VisualBasic.Core.dll

Source:

TextFieldParser.vb

Fournit des méthodes et des propriétés pour analyser des fichiers texte structurés.

public ref class TextFieldParser : IDisposable

public class TextFieldParser : IDisposable

type TextFieldParser = class
    interface IDisposable

Public Class TextFieldParser
Implements IDisposable

Héritage

Object

TextFieldParser

Implémente

IDisposable

Exemples

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

Remarques

L’objet TextFieldParser fournit des méthodes et des propriétés pour l’analyse des fichiers texte structurés. L’analyse d’un fichier texte avec le TextFieldParser est similaire à une itération sur un fichier texte, tandis que l’utilisation de la ReadFields méthode pour extraire des champs de texte est similaire à la division des chaînes.

Le TextFieldParser peut analyser deux types de fichiers : délimités ou à largeur fixe. Certaines propriétés, telles que Delimiters et HasFieldsEnclosedInQuotes , ne sont significatives que lorsque vous travaillez avec des fichiers délimités, tandis que la propriété ne l’est FieldWidths que lorsque vous utilisez des fichiers à largeur fixe.

Le tableau suivant liste des exemples de tâches impliquant l’objet Microsoft.VisualBasic.FileIO.TextFieldParser.

À	Consultez
Lecture à partir d’un fichier texte délimité	Procédure : lire des fichiers texte délimités par des virgules
Lecture à partir d’un fichier texte à largeur fixe	Procédure : lire des fichiers texte de largeur fixe
Lecture à partir d’un fichier texte avec plusieurs formats	Procédure : lire des fichiers texte avec plusieurs formats

Constructeurs

TextFieldParser(Stream)	Initialise une nouvelle instance de la classe TextFieldParser.
TextFieldParser(Stream, Encoding)	Initialise une nouvelle instance de la classe TextFieldParser.
TextFieldParser(Stream, Encoding, Boolean)	Initialise une nouvelle instance de la classe TextFieldParser.
TextFieldParser(Stream, Encoding, Boolean, Boolean)	Initialise une nouvelle instance de la classe TextFieldParser.
TextFieldParser(String)	Initialise une nouvelle instance de la classe TextFieldParser.
TextFieldParser(String, Encoding)	Initialise une nouvelle instance de la classe TextFieldParser.
TextFieldParser(String, Encoding, Boolean)	Initialise une nouvelle instance de la classe TextFieldParser.
TextFieldParser(TextReader)	Initialise une nouvelle instance de la classe TextFieldParser.

Propriétés

CommentTokens	Définit des jetons de commentaire. Un jeton de commentaire est une chaîne qui, lorsqu'elle est placée au début d'une ligne, indique que la ligne est un commentaire et doit être ignorée par l'analyseur.
Delimiters	Définit les séparateurs pour un fichier texte.
EndOfData	Retourne True s'il n'y a aucune ligne non vide, sans commentaire, entre la position actuelle du curseur et la fin du fichier.
ErrorLine	Retourne la ligne qui a provoqué l'exception MalformedLineException la plus récente.
ErrorLineNumber	Retourne le numéro de la ligne qui a provoqué l'exception MalformedLineException la plus récente.
FieldWidths	Désigne la largeur de chaque colonne du fichier texte en cours d'analyse.
HasFieldsEnclosedInQuotes	Indique si les champs sont placés entre guillemets lorsqu'un fichier délimité est analysé.
LineNumber	Retourne le nombre de lignes en cours, ou retourne -1 si aucun caractère n'est disponible dans le flux.
TextFieldType	Indique si le fichier à analyser est délimité ou à largeur fixe.
TrimWhiteSpace	Indique si les espaces blancs de début et de fin doivent être supprimés des valeurs de champs.

Méthodes

Close()	Ferme l'objet TextFieldParser en cours.
Dispose()	Libère les ressources utilisées par l’objet TextFieldParser.
Dispose(Boolean)	Libère les ressources utilisées par l’objet TextFieldParser.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Finalize()	Permet à l'objet TextFieldParser de tenter de libérer des ressources et d'effectuer d'autres opérations de nettoyage avant d'être récupéré par l'opération garbage collection.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
PeekChars(Int32)	Lit le nombre spécifié de caractères sans avancer le curseur.
ReadFields()	Lit tous les champs sur la ligne active, les retourne sous la forme d'un tableau de chaînes et avance le curseur vers la ligne suivante contenant des données.
ReadLine()	Retourne la ligne active en tant que chaîne et avance le curseur vers la ligne suivante.
ReadToEnd()	Lit le reste du fichier texte et le retourne en tant que chaîne.
SetDelimiters(String[])	Affecte les valeurs spécifiées aux séparateurs pour le lecteur et la valeur Delimited au type de champ.
SetFieldWidths(Int32[])	Affecte les valeurs spécifiées aux séparateurs pour le lecteur.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• OpenTextFieldParser(String)
• Objets (Visual Basic)
• Analyse des fichiers texte avec l'objet TextFieldParser
• Dépannage des exceptions : Microsoft.VisualBasic.FileIO.TextFieldParser.MalformedLineException