TextFieldParser 클래스

정의

구조화된 텍스트 파일을 구문 분석하기 위한 메서드와 속성을 제공합니다.Provides methods and properties for parsing structured text files.

public ref class TextFieldParser : IDisposable
public class TextFieldParser : IDisposable
type TextFieldParser = class
    interface IDisposable
Public Class TextFieldParser
Implements IDisposable
상속
TextFieldParser
구현

예제

이 예제에서는 탭으로 구분 된 텍스트 파일을 구문 분석 Bigfile합니다.This example parses through a tab-delimited text file, 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

설명

TextFieldParser 구조화 된 텍스트 파일 구문 분석에 대 한 속성 및 메서드를 제공 하는 개체입니다.The TextFieldParser object provides methods and properties for parsing structured text files. 사용 하 여 텍스트 파일을 구문 분석 합니다 TextFieldParser 텍스트 파일을 반복 하는 것과 비슷합니다 하는 동안는 ReadFields 텍스트 필드를 추출 하는 메서드는 문자열을 분할 합니다.Parsing a text file with the TextFieldParser is similar to iterating over a text file, while the ReadFields method to extract fields of text is similar to splitting the strings.

TextFieldParser 두 가지 유형의 파일을 구문 분석할 수 있습니다: 구분 기호로 분리 된 파일 인지 또는 고정 너비입니다.The TextFieldParser can parse two types of files: delimited or fixed-width. 일부 속성을 같은 DelimitersHasFieldsEnclosedInQuotes 만 의미 하는 동안 구분 기호로 분리 된 파일을 사용 하는 경우는 FieldWidths 속성은 고정 너비 파일을 사용 하는 경우에 의미가.Some properties, such as Delimiters and HasFieldsEnclosedInQuotes are meaningful only when working with delimited files, while the FieldWidths property is meaningful only when working with fixed-width files.

다음 표에서 관련 된 작업의 예제는 Microsoft.VisualBasic.FileIO.TextFieldParser 개체입니다.The following table lists examples of tasks involving the Microsoft.VisualBasic.FileIO.TextFieldParser object.

대상To 참조See
구분 기호로 분리 된 텍스트 파일에서 읽기Read from a delimited text file 방법: 쉼표로 구분된 텍스트 파일에서 읽기How to: Read From Comma-Delimited Text Files
고정 너비 텍스트 파일에서 읽기Read from a fixed-width text file 방법: 고정 너비 텍스트 파일에서 읽기How to: Read From Fixed-width Text Files
여러 형식의 텍스트 파일에서 읽기Read from a text file with multiple formats 방법: 여러 형식의 텍스트 파일에서 읽기How to: Read From Text Files with Multiple Formats

생성자

TextFieldParser(Stream)

TextFieldParser 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TextFieldParser class.

TextFieldParser(Stream, Encoding)

TextFieldParser 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TextFieldParser class.

TextFieldParser(Stream, Encoding, Boolean)

TextFieldParser 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TextFieldParser class.

TextFieldParser(Stream, Encoding, Boolean, Boolean)

TextFieldParser 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TextFieldParser class.

TextFieldParser(String)

TextFieldParser 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TextFieldParser class.

TextFieldParser(String, Encoding)

TextFieldParser 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TextFieldParser class.

TextFieldParser(String, Encoding, Boolean)

TextFieldParser 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TextFieldParser class.

TextFieldParser(TextReader)

TextFieldParser 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the TextFieldParser class.

속성

CommentTokens

주석 토큰을 정의합니다.Defines comment tokens. 주석 토큰은 줄 시작 부분에서 해당 줄이 주석이므로 파서에서 무시해야 함을 나타내는 문자열입니다.A comment token is a string that, when placed at the beginning of a line, indicates that the line is a comment and should be ignored by the parser.

Delimiters

텍스트 파일의 구분 기호를 정의합니다.Defines the delimiters for a text file.

EndOfData

현재 커서 위치와 파일 끝 사이에 공백 또는 주석이 없는 줄이 있는 경우 True를 반환합니다.Returns True if there are no non-blank, non-comment lines between the current cursor position and the end of the file.

ErrorLine

최신 MalformedLineException 예외를 발생시킨 줄을 반환합니다.Returns the line that caused the most recent MalformedLineException exception.

ErrorLineNumber

최신 MalformedLineException 예외를 발생시킨 줄 번호를 반환합니다.Returns the number of the line that caused the most recent MalformedLineException exception.

FieldWidths

구문 분석되는 텍스트 파일에서 각 열의 너비를 나타냅니다.Denotes the width of each column in the text file being parsed.

HasFieldsEnclosedInQuotes

구분된 파일을 구문 분석할 때 필드가 따옴표로 묶여 있는지 여부를 나타냅니다.Denotes whether fields are enclosed in quotation marks when a delimited file is being parsed.

LineNumber

현재 줄 번호를 반환하거나 스트림에서 더 이상 문자를 사용할 수 없으면 -1을 반환합니다.Returns the current line number, or returns -1 if no more characters are available in the stream.

TextFieldType

구문 분석할 파일이 구분된 파일인지 또는 고정 너비 파일인지 여부를 나타냅니다.Indicates whether the file to be parsed is delimited or fixed-width.

TrimWhiteSpace

필드 값에서 선행 및 후행 공백이 삭제되어야 하는지 여부를 나타냅니다.Indicates whether leading and trailing white space should be trimmed from field values.

메서드

Close()

현재 TextFieldParser 개체를 닫습니다.Closes the current TextFieldParser object.

Dispose()

해당 TextFieldParser 개체에서 사용하는 리소스를 해제합니다.Releases resources used by the TextFieldParser object.

Dispose(Boolean)

해당 TextFieldParser 개체에서 사용하는 리소스를 해제합니다.Releases resources used by the TextFieldParser object.

Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(다음에서 상속됨 Object)
Finalize()

가비지 수집기에서 회수하기 전에 TextFieldParser 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다.Allows the TextFieldParser object to attempt to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(다음에서 상속됨 Object)
GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(다음에서 상속됨 Object)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(다음에서 상속됨 Object)
PeekChars(Int32)

커서를 앞으로 이동하지 않고 지정한 문자 수를 읽습니다.Reads the specified number of characters without advancing the cursor.

ReadFields()

현재 줄의 모든 필드를 읽고 문자열 배열로서 반환한 다음 데이터가 포함된 다음 줄로 커서를 이동합니다.Reads all fields on the current line, returns them as an array of strings, and advances the cursor to the next line containing data.

ReadLine()

현재 줄을 문자열로 반환하고 커서를 다음 줄로 이동합니다.Returns the current line as a string and advances the cursor to the next line.

ReadToEnd()

텍스트 파일의 나머지를 읽고 문자열로 반환합니다.Reads the remainder of the text file and returns it as a string.

SetDelimiters(String[])

판독기의 구분 기호를 지정된 값으로 설정하고 필드 형식을 Delimited로 설정합니다.Sets the delimiters for the reader to the specified values, and sets the field type to Delimited.

SetFieldWidths(Int32[])

지정한 값에 대한 판독기의 구분 기호를 설정합니다.Sets the delimiters for the reader to the specified values.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

IDisposable.Dispose()

해당 TextFieldParser 개체에서 사용하는 리소스를 해제합니다.Releases resources used by the TextFieldParser object.

적용 대상

추가 정보