My.Computer.FileSystem.OpenTextFieldParser-Methode
Aktualisiert: November 2007
Mit der OpenTextFieldParser-Methode kann ein TextFieldParser-Objekt erstellt werden, mit dessen Hilfe strukturierte Textdateien, z. B. Protokolle, sowohl einfach als auch effizient analysiert werden können. Das TextFieldParser-Objekt kann zum Lesen von Dateien sowohl mit Trennzeichen als auch mit fester Breite verwendet werden.
' 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
Parameter
file
String. Die Datei, die mit dem TextFieldParser geöffnet werden soll. Erforderlich.delimiters
String(). Trennzeichen für die Felder. Erforderlich.fieldWidths
Integer(). Breiten der Felder. Erforderlich.
Rückgabewert
Ausnahmen
Die folgenden Bedingungen können eine Ausnahme verursachen:
Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).
Der Dateiname endet mit einem nachgestellten Schrägstrich (ArgumentException).
Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).
Die angegebene Datei ist nicht vorhanden (FileNotFoundException).
Die angegebene Datei wird gegenwärtig verwendet (IOException).
Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format (NotSupportedException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).
Eine Zeile kann nicht mit dem angegebenen Format analysiert werden (MalformedLineException). In der Ausnahmemeldung wird die Zeile angegeben, die die Ausnahme verursacht, während dem Text in der Zeile die TextFieldParser.ErrorLine-Eigenschaft-Eigenschaft zugewiesen ist.
Der Benutzer verfügt nicht über ausreichende Berechtigungen für den Zugriff auf die Datei (UnauthorizedAccessException).
Aufgaben
In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.FileSystem.OpenTextFieldParser-Methode aufgeführt.
Zweck |
Weitere Informationen finden Sie unter |
|---|---|
Lesen aus einer Textdatei mit Trennzeichen |
Gewusst wie: Lesen aus durch Kommas getrennten Textdateien in Visual Basic |
Lesen aus einer Textdatei mit fester Breite |
Gewusst wie: Lesen aus einer Textdatei mit fester Breite in Visual Basic |
Lesen aus einer Textdatei mit mehreren Formaten |
Gewusst wie: Lesen aus Textdateien mit mehreren Formaten in Visual Basic |
Beispiel
In diesem Beispiel wird der reader von TextFieldParser geöffnet und zum Lesen von C:\TestFolder1\Test1.txt verwendet.
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
Anforderungen
Namespace:Microsoft.VisualBasic.MyServices
Klasse:FileSystemProxy (ermöglicht den Zugriff auf FileSystem)
Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)
Verfügbarkeit nach Projekttyp
Projekttyp |
Verfügbar |
|---|---|
Windows-Anwendung |
Ja |
Klassenbibliothek |
Ja |
Konsolenanwendung |
Ja |
Windows-Steuerelementbibliothek |
Ja |
Web-Steuerelementbibliothek |
Ja |
Windows-Dienst |
Ja |
Website |
Ja |
Berechtigungen
Die folgenden Berechtigungen sind möglicherweise erforderlich:
Berechtigung |
Beschreibung |
|---|---|
Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted. |
|
Beschreibt einen Satz von Sicherheitsberechtigungen, die auf Code angewendet werden. Zugeordnete Enumeration: ControlEvidence. |
Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.
Siehe auch
Aufgaben
Gewusst wie: Lesen von Textdateien in Visual Basic
Gewusst wie: Lesen aus durch Kommas getrennten Textdateien in Visual Basic
Gewusst wie: Lesen aus Textdateien mit mehreren Formaten in Visual Basic
Konzepte
Analysieren von Textdateien mit dem TextFieldParser-Objekt