XmlWriter.WriteSurrogateCharEntity(Char, Char) 메서드

정의

네임스페이스:

System.Xml

어셈블리:

System.Xml.ReaderWriter.dll

어셈블리:

System.Xml.dll

어셈블리:

netstandard.dll

파생 클래스에서 재정의되면 서로게이트 문자 쌍에 대한 서로게이트 문자 엔터티를 생성하고 작성합니다.

public:
 abstract void WriteSurrogateCharEntity(char lowChar, char highChar);

public abstract void WriteSurrogateCharEntity (char lowChar, char highChar);

abstract member WriteSurrogateCharEntity : char * char -> unit

Public MustOverride Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)

매개 변수

lowChar

Char

하위 서로게이트입니다. 이 값은 0xDC00에서 0xDFFF 사이에 있어야 합니다.

highChar

Char

상위 서로게이트입니다. 이 값은 0xD800에서 0xDBFF 사이에 있어야 합니다.

예외

ArgumentException

잘못된 서로게이트 문자 쌍이 전달된 경우

InvalidOperationException

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.

설명

이 방법은 UTF-16 인코딩을 사용하는 시스템에만 적용됩니다.

서로게이트 문자 엔터티는 16진수 형식으로 작성됩니다. 서로게이트 문자의 범위는 #x10FFFF #x10000. 다음 수식은 서로게이트 문자 엔터티를 생성하는 데 사용됩니다. (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

HTML과 XML의 경우 문서 문자 집합(따라서 숫자 참조 표기법)은 UCS [ISO-10646]을 기반으로 합니다. 따라서 원본 문서의 단일 숫자 문자 참조는 문자열에서 두 개의 16비트 단위(높은 서로게이트 및 낮은 서로게이트)에 해당할 수 있습니다. 이러한 16비트 단위를 서로게이트 쌍이라고 합니다.

서로게이트 또는 문자에 대한 자세한 내용은 W3C XML 1.0 권장 사항의 2.2 또는 섹션 2.2에 https://www.unicode.org있는 유니코드 3.0/유니코드 2.0 표준의 섹션 3.7을 참조하세요.

이 메서드의 비동기 버전은 다음을 참조하세요 WriteSurrogateCharEntityAsync.