Match 클래스

정의

네임스페이스:

System.Text.RegularExpressions

어셈블리:

netstandard.dll, System.Text.RegularExpressions.dll

Source:

Match.cs

단일 정규식 일치의 결과를 나타냅니다.

public ref class Match : System::Text::RegularExpressions::Group

public class Match : System.Text.RegularExpressions.Group

type Match = class
    inherit Group

Public Class Match
Inherits Group

상속

Object

Capture

Group

Match

설명

Match 클래스는 변경할 수 없으며 공용 생성자가 없습니다. 클래스의 Match 인스턴스는 메서드에서 Match(String) 반환되며 문자열의 첫 번째 패턴 일치를 나타냅니다. 이후 일치 항목은 메서드에서 Match 반환된 개체로 NextMatch() 표시됩니다. 또한 MatchCollection 0개, 하나 이상의 Match 개체로 구성된 개체는 메서드에서 Matches(String) 반환됩니다.

메서드가 입력 문자열의 Matches(String) 정규식 패턴과 일치하지 않으면 빈 MatchCollection 개체를 반환합니다. 그런 다음, 구문을 사용하여 foreach 컬렉션을 반복할 수 있습니다.

메서드가 Match(String) 정규식 패턴과 일치하지 않으면 같은 Match개체를 Empty 반환합니다. 속성을 사용하여 일치가 Success 성공했는지 여부를 확인할 수 있습니다.

패턴 일치에 성공 Value 하면 속성에 일치하는 부분 문자열이 포함되고, Index 속성은 입력 문자열에서 일치하는 부분 문자열의 0부터 시작하는 위치를 나타내고 Length , 속성은 입력 문자열에서 일치하는 부분 문자열의 길이를 나타냅니다.

단일 일치 항목에는 여러 캡처링 그룹이 Match 포함될 수 있으므로 반환되는 Groups 속성이 GroupCollection있습니다. Match 인스턴스 자체는 전체 일치 항목을 나타내는 컬렉션의 첫 번째 개체와 Match.Groups[0]동일합니다.

속성

Name	Description
Captures	캡처링 그룹과 일치하는 모든 캡처의 컬렉션을 가장 안쪽에서 맨 왼쪽 우선 순서로 가져옵니다(또는 정규식이 옵션으로 RightToLeft 수정된 경우 가장 안쪽에서 맨 오른쪽 우선 순서). 컬렉션에 항목이 0개 이상 있을 수 있습니다. (다음에서 상속됨 Group)
Empty	빈 일치 항목을 가져옵니다. 실패한 모든 일치 항목은 이 빈 일치 항목을 반환합니다.
Groups	정규식과 일치하는 그룹의 컬렉션을 가져옵니다.
Index	캡처된 부분 문자열의 첫 번째 문자가 있는 원래 문자열의 위치를 가져옵니다. (다음에서 상속됨 Capture)
Length	캡처된 부분 문자열의 길이를 가져옵니다. (다음에서 상속됨 Capture)
Name	현재 인스턴스가 나타내는 캡처링 그룹의 이름을 반환합니다. (다음에서 상속됨 Group)
Success	일치가 성공했는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 Group)
Value	입력 문자열에서 캡처된 부분 문자열을 가져옵니다. (다음에서 상속됨 Capture)
ValueSpan	입력 문자열에서 캡처된 범위를 가져옵니다. (다음에서 상속됨 Capture)

메서드

Name	Description
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
NextMatch()	마지막 일치가 종료된 위치(마지막으로 일치하는 문자 뒤의 문자)에서 시작하여 다음 일치에 대한 결과가 포함된 새 Match 개체를 반환합니다.
Result(String)	전달된 대체 패턴의 확장을 반환합니다. 예를 들어 대체 패턴이 $1$2Result(String)Groups[1].Value 면 연결과 .Groups[2].Value
Synchronized(Match)	Match 여러 스레드 간에 안전하게 공유할 수 있는 제공된 인스턴스와 동일한 인스턴스를 반환합니다.
ToString()	속성을 호출하여 입력 문자열에서 캡처된 부분 문자열을 검색합니다 Value . (다음에서 상속됨 Capture)

추가 정보

• MatchCollection
• Regex