TextFieldParser Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Metódusokat és tulajdonságokat biztosít a strukturált szövegfájlok elemzéséhez.
public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
interface IDisposable
Public Class TextFieldParser
Implements IDisposable
- Öröklődés
-
TextFieldParser
- Megvalósítás
Példák
Ez a példa egy tabulátorral tagolt szövegfájlon keresztül elemez. 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
Megjegyzések
Az TextFieldParser objektum metódusokat és tulajdonságokat biztosít a strukturált szövegfájlok elemzéséhez. A szövegfájl TextFieldParser elemzése hasonló a szövegfájlon végzett iteráláshoz, míg a ReadFields szövegmezők kinyerésének módszere hasonló a sztringek felosztásához.
Két TextFieldParser fájltípust elemezhet: tagolt vagy rögzített szélességű. Egyes tulajdonságok, például DelimitersHasFieldsEnclosedInQuotes csak a tagolt fájlok használata esetén értelmezhetők, míg a FieldWidths tulajdonság csak rögzített szélességű fájlok használatakor értelmezhető.
Az alábbi táblázat példákat sorol fel az Microsoft.VisualBasic.FileIO.TextFieldParser objektumot érintő tevékenységekre.
| Címzett | Nézze |
|---|---|
| Olvasás tagolt szövegfájlból | Útmutató: Olvasás Comma-Delimited szövegfájlokból |
| Olvasás rögzített szélességű szövegfájlból | Útmutató: Olvasás rögzített szélességű szövegfájlokból |
| Olvasás több formátumot tartalmazó szövegfájlból | Útmutató: Olvasás több formátumot tartalmazó szövegfájlokból |
Konstruktorok
| Name | Description |
|---|---|
| TextFieldParser(Stream, Encoding, Boolean, Boolean) |
Inicializálja a |
| TextFieldParser(Stream, Encoding, Boolean) |
Inicializálja a |
| TextFieldParser(Stream, Encoding) |
Inicializálja a |
| TextFieldParser(Stream) |
Inicializálja a |
| TextFieldParser(String, Encoding, Boolean) |
Inicializálja a |
| TextFieldParser(String, Encoding) |
Inicializálja a |
| TextFieldParser(String) |
Inicializálja a |
| TextFieldParser(TextReader) |
Inicializálja a |
Tulajdonságok
| Name | Description |
|---|---|
| CommentTokens |
Megjegyzés jogkivonatokat határoz meg. A megjegyzés jogkivonata egy olyan sztring, amely egy sor elején elhelyezve azt jelzi, hogy a sor megjegyzés, és az elemzőnek figyelmen kívül kell hagynia. |
| Delimiters |
Meghatározza egy szövegfájl elválasztóit. |
| EndOfData |
Akkor adja |
| ErrorLine |
A legutóbbi MalformedLineException kivételt okozó sort adja vissza. |
| ErrorLineNumber |
A legutóbbi MalformedLineException kivételt okozó sor számát adja vissza. |
| FieldWidths |
Az elemzett szövegfájl egyes oszlopainak szélességét jelöli. |
| HasFieldsEnclosedInQuotes |
Azt jelzi, hogy a mezők idézőjelek közé vannak-e zárva egy tagolt fájl elemzésekor. |
| LineNumber |
Az aktuális sor számát adja vissza, vagy -1 ad vissza, ha nincs több karakter a streamben. |
| TextFieldType |
Azt jelzi, hogy az elemezni kívánt fájl el van-e tagolt vagy rögzített szélességű. |
| TrimWhiteSpace |
Azt jelzi, hogy a kezdő és a záró szóközt levágni kell-e a mezőértékekből. |
Metódusok
| Name | Description |
|---|---|
| Close() |
Bezárja az aktuális |
| Dispose() |
Felszabadítja az TextFieldParser objektum által használt erőforrásokat. |
| Dispose(Boolean) |
Felszabadítja az TextFieldParser objektum által használt erőforrásokat. |
| Equals(Object) |
Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object) |
| Finalize() |
Lehetővé teszi, hogy az TextFieldParser objektum megkísérlje felszabadítani az erőforrásokat, és más tisztítási műveleteket hajt végre, mielőtt a szemétgyűjtés visszanyeri azt. |
| GetHashCode() |
Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object) |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| PeekChars(Int32) |
Beolvassa a megadott számú karaktert a kurzor előrehaladása nélkül. |
| ReadFields() |
Beolvassa az aktuális sor összes mezőjét, sztringtömbként adja vissza őket, és a kurzort az adatokat tartalmazó következő sorba viszi. |
| ReadLine() |
Sztringként adja vissza az aktuális sort, és a kurzort a következő sorra viszi. |
| ReadToEnd() |
Beolvassa a szövegfájl fennmaradó részét, és sztringként adja vissza. |
| SetDelimiters(String[]) |
Az olvasó elválasztóit a megadott értékekre állítja, és a mezőtípust a következőre |
| SetFieldWidths(Int32[]) |
Az olvasó elválasztóit a megadott értékekre állítja. |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |