My.Computer.FileSystem.OpenTextFieldParser, méthode
Mise à jour : novembre 2007
La méthode OpenTextFieldParser vous permet de créer un objet TextFieldParser et d'analyser efficacement les fichiers texte structurés, comme les journaux. L'objet TextFieldParser peut être utilisé pour lire des fichiers délimités et à largeur fixe.
' Usage
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file)
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file ,delimiters)
Dim value As TextFieldParser = My.Computer.FileSystem.OpenTextFieldParser(file ,fieldWidths)
' Declaration
Public Function OpenTextFieldParser( _
ByVal file As String _
) As TextFieldParser
' -or-
Public Function OpenTextFieldParser( _
ByVal file As String, _
ByVal delimiters As String() _
) As TextFieldParser
' -or-
Public Function OpenTextFieldParser( _
ByVal file As String, _
ByVal fieldWidths As Integer() _
) As TextFieldParser
Paramètres
file
String. Fichier à ouvrir avec TextFieldParser. Obligatoire.delimiters
String(). Séparateurs pour les champs. Obligatoire.fieldWidths
Integer(). Largeurs des champs. Obligatoire.
Valeur de retour
Exceptions
Les conditions ci-dessous peuvent générer une exception :
Le chemin d'accès n'est pas valide pour une des raisons suivantes : il s'agit d'une chaîne de longueur nulle ; il ne contient que des espaces blancs ; il contient des caractères non valides ou il s'agit d'un chemin d'accès de périphérique (qui commence par \\.\) (ArgumentException).
le nom de fichier se termine par une barre oblique finale (ArgumentException) ;
le chemin d'accès n'est pas valide, car il a la valeur Nothing (ArgumentNullException) ;
le fichier spécifié n'existe pas (FileNotFoundException) ;
le fichier spécifié est en cours d'utilisation (IOException) ;
le chemin d'accès dépasse la longueur maximale définie par le système (PathTooLongException) ;
un nom de fichier ou de répertoire du chemin d'accès contient un signe deux-points (:) ou n'a pas un format correct (NotSupportedException) ;
l'utilisateur n'a pas les autorisations nécessaires pour afficher le chemin d'accès (SecurityException) ;
une ligne ne peut pas être analysée avec le format spécifié (MalformedLineException). Le message d'exception spécifie la ligne qui provoque l'exception, tandis que le texte contenu dans la ligne est assigné à la propriété TextFieldParser.ErrorLine.
l'utilisateur n'a pas les autorisations suffisantes pour accéder au fichier (UnauthorizedAccessException).
Tâches
Le tableau suivant répertorie des exemples de tâches impliquant la méthode My.Computer.FileSystem.OpenTextFieldParser.
Pour |
Reportez-vous à |
|---|---|
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 ouvre readerTextFieldParser et l'utilise pour lire C:\TestFolder1\Test1.txt.
Dim reader As Microsoft.VisualBasic.FileIO.TextFieldParser
reader = My.Computer.FileSystem.OpenTextFieldParser _
("C:\TestFolder1\test1.txt")
reader.TextFieldType = Microsoft.VisualBasic.FileIO.FieldType.Delimited
reader.delimiters = New String() {","}
Dim currentRow As String()
While Not reader.EndOfData
Try
currentRow = reader.ReadFields()
Dim currentField As String
For Each currentField In currentRow
MsgBox(currentField)
Next
Catch ex As Microsoft.VisualBasic.FileIO.MalformedLineException
MsgBox("Line " & ex.Message & _
"is not valid and will be skipped.")
End Try
End While
Configuration requise
Espace de noms :Microsoft.VisualBasic.MyServices
Classe :FileSystemProxy (fournit l'accès à FileSystem)
Assembly : bibliothèque Runtime Visual Basic (dans Microsoft.VisualBasic.dll)
Disponibilité par type de projet
Type de projet |
Disponible |
|---|---|
Application Windows |
Oui |
Bibliothèque de classes |
Oui |
Application console |
Oui |
Bibliothèque de contrôles Windows |
Oui |
Bibliothèque de contrôles Web |
Oui |
Service Windows |
Oui |
Site Web |
Oui |
Autorisations
Les autorisations suivantes peuvent être nécessaires :
Autorisation |
Description |
|---|---|
Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted. |
|
Décrit un ensemble d'autorisations de sécurité appliqué 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
Tâches
Comment : lire des fichiers texte dans Visual Basic
Comment : lire des fichiers texte délimités par des virgules dans Visual Basic
Comment : lire des fichiers texte avec plusieurs formats dans Visual Basic
Concepts
Analyse des fichiers texte avec l'objet TextFieldParser