TextFieldParser Classe

Définition

Espace de noms:
Microsoft.VisualBasic.FileIO
Assembly:
Microsoft.VisualBasic.dll

Fournit des méthodes et des propriétés pour l’analyse 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 fichier est similaire à l’itération sur un fichier texte, tandis que l’utilisation de la ReadFields méthode pour extraire des champs de texte est similaire au fractionnement des chaînes.

Il 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 utilisez des fichiers délimités, tandis que la propriété n’est significative que lorsque vous FieldWidths utilisez des fichiers à largeur fixe.

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

À Consultez
Lecture à partir d’un fichier texte délimité Comment lire à partir de fichiers texte Comma-Delimited
Lecture à partir d’un fichier texte à largeur fixe Guide pratique pour lire à partir de fichiers texte à largeur fixe
Lire à partir d’un fichier texte avec plusieurs formats Guide pratique pour lire des fichiers texte avec plusieurs formats

Constructeurs

Nom Description
TextFieldParser(Stream, Encoding, Boolean, Boolean)

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

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

Initialise une nouvelle instance de la classe TextFieldParser.
TextFieldParser(Stream)

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

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

Initialise une nouvelle instance de la classe TextFieldParser.
TextFieldParser(String)

Initialise une nouvelle instance de la classe TextFieldParser.
TextFieldParser(TextReader)

Initialise une nouvelle instance de la classe TextFieldParser.

Propriétés

Nom Description
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 délimiteurs d’un fichier texte.
EndOfData

Retourne True s’il n’existe 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 la plus récente MalformedLineException .
ErrorLineNumber

Retourne le nombre de lignes qui ont provoqué l’exception la plus récente MalformedLineException .
FieldWidths

Indique la largeur de chaque colonne du fichier texte analysé.
HasFieldsEnclosedInQuotes

Indique si les champs sont placés entre guillemets lorsqu’un fichier délimité est analysé.
LineNumber

Retourne le numéro de ligne actuel ou retourne -1 si aucun plus de caractères n’est disponible dans le flux.
TextFieldType

Indique si le fichier à analyser est délimité ou à largeur fixe.
TrimWhiteSpace

Indique si l’espace blanc de début et de fin doit être supprimé des valeurs de champ.

Méthodes

Nom Description
Close()

Ferme l’objet actuel TextFieldParser .
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 qu’il ne soit récupéré par garbage collection.
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
PeekChars(Int32)

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

Lit tous les champs de la ligne actuelle, les retourne sous forme de tableau de chaînes et avance le curseur vers la ligne suivante contenant des données.
ReadLine()

Retourne la ligne actuelle sous forme de chaîne et avance le curseur vers la ligne suivante.
ReadToEnd()

Lit le reste du fichier texte et le retourne sous forme de chaîne.
SetDelimiters(String[])

Définit les délimiteurs du lecteur sur les valeurs spécifiées et définit le type Delimitedde champ sur .
SetFieldWidths(Int32[])

Définit les délimiteurs pour le lecteur sur les valeurs spécifiées.
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

S’applique à

Voir aussi