TextFieldParser.ReadFields Méthode

Définition

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.

public string[]? ReadFields ();
public string[] ReadFields ();

Retours

String[]

Tableau de chaînes qui contient les valeurs de champs pour la ligne active.

Exceptions

Un champ ne peut pas être analysé à l'aide du format spécifié.

Exemples

Cet exemple utilise la ReadFields méthode pour lire à partir du fichier ParserText.txtdélimité par des virgules . L’exemple écrit les champs dans Testfile.txt.

Using MyReader As New Microsoft.VisualBasic.FileIO.TextFieldParser("C:\ParserText.txt")
    MyReader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
    MyReader.Delimiters = New String() {","}
    Dim currentRow As String()
    While Not MyReader.EndOfData
        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

Remarques

Pour permettre aux utilisateurs d’analyser des fichiers texte dans plusieurs formats, la ReadFields méthode examine les valeurs de TextFieldType, Delimiterset FieldWidths, si elles sont spécifiées, chaque fois qu’elle est appelée. Les utilisateurs doivent configurer correctement les TextFieldType propriétés et FieldWidths ou Delimiters , le cas échéant. Si TextFieldType a la Delimitedvaleur et Delimiters n’est pas défini, ou si TextFieldType a la FixedWidth valeur et FieldWidths, une exception est levée.

Si ReadFields rencontre des lignes vides, elles sont ignorées et la ligne non vide suivante est retournée.

Si la ReadFields méthode ne peut pas analyser la ligne active, elle lève une exception et ne passe pas à la ligne suivante. Cela permet à votre application de réessayer d’analyser la ligne.

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

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

S’applique à

Produit Versions
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Voir aussi