XmlWriter.WriteSurrogateCharEntity(Char, Char) XmlWriter.WriteSurrogateCharEntity(Char, Char) XmlWriter.WriteSurrogateCharEntity(Char, Char) XmlWriter.WriteSurrogateCharEntity(Char, Char) Method

정의

파생 클래스에서 재정의되면 서로게이트 문자 쌍에 대한 서로게이트 문자 엔터티를 생성하고 작성합니다.When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair.

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 Char Char Char

하위 서로게이트입니다.The low surrogate. 이 값은 0xDC00에서 0xDFFF 사이에 있어야 합니다.This must be a value between 0xDC00 and 0xDFFF.

highChar
Char Char Char Char

상위 서로게이트입니다.The high surrogate. 이 값은 0xD800에서 0xDBFF 사이에 있어야 합니다.This must be a value between 0xD800 and 0xDBFF.

예외

잘못된 서로게이트 문자 쌍이 전달된 경우An invalid surrogate character pair was passed.

이전 비동기 작업이 완료되기 전에 XmlWriter 메서드가 호출되었습니다.An XmlWriter method was called before a previous asynchronous operation finished. 이 경우 “비동기 작업이 이미 진행 중입니다.” 메시지를 나타내며 InvalidOperationException이 throw됩니다.In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

설명

이 메서드는 utf-16 인코딩을 사용 하는 시스템에 적용할 수만 있습니다.This method is only applicable on systems that use UTF-16 encoding.

서로게이트 문자 엔터티는 16 진수 형식으로 기록 됩니다.The surrogate character entity is written in hexadecimal format. 서로게이트 문자에 대 한 범위 #x에서 # x10ffff 사이입니다.The range for surrogate characters is #x10000 to #x10FFFF. 다음 수식을 사용 하는 서로게이트 문자 엔터티를 생성할: (highChar -이 0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000The following formula is used to generate the surrogate character entity: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

HTML 및 XML을 문서 문자 집합 (및 따라서 숫자 문자 참조의 표기) 기반으로 UCS [ISO 10646] 합니다.For both HTML and XML, the document character set (and therefore the notation of numeric character references) is based on UCS [ISO-10646]. 원본 문서에 대 한 단일 숫자 문자 참조 (high surrogate 및 하위 서로게이트) 문자열에서 두 명의 16 비트 장치에 해당할 경우에 따라 따라서 수 있습니다.A single numeric character reference in a source document may therefore in some cases correspond to two 16-bit units in a string (a high surrogate and a low surrogate). 이러한 16 비트 단위 서로게이트 쌍 이라고 합니다.These 16-bit units are referred to as a surrogate pair.

문자나 서로게이트에 대 한 자세한 내용은 섹션 3.7 유니코드 표준 3.0 유니코드 2.0에 있는 참조 https://www.unicode.org, 또는 W3C XML 1.0 Recommendation의 2.2 섹션합니다.For more information regarding surrogates or characters, refer to section 3.7 of the Unicode 3.0/Unicode 2.0 standard located at https://www.unicode.org, or section 2.2 of the W3C XML 1.0 Recommendation.

이 메서드의 비동기 버전을 참조 하세요. WriteSurrogateCharEntityAsync합니다.For the asynchronous version of this method, see WriteSurrogateCharEntityAsync.

적용 대상