XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Metod

Definition

Genererar och skriver surrogatteckenentiteten för surrogatteckenparet.

public:
 override void WriteSurrogateCharEntity(char lowChar, char highChar);
public override void WriteSurrogateCharEntity(char lowChar, char highChar);
override this.WriteSurrogateCharEntity : char * char -> unit
Public Overrides Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)

Parametrar

lowChar
Char

Den låga surrogatmamman. Detta måste vara ett värde mellan 0xDC00 och 0xDFFF.

highChar
Char

Den höga surrogaten. Detta måste vara ett värde mellan 0xD800 och 0xDBFF.

Undantag

Ett ogiltigt surrogatteckenpar skickades.

Kommentarer

Note

Vi rekommenderar att du skapar XmlWriter instanser med hjälp av XmlWriter.Create metoden och XmlWriterSettings klassen för att dra nytta av den nya funktionaliteten.

Den här metoden gäller endast för system som använder UTF-16-kodning.

Entiteten surrogattecken är skriven i hexadecimalt format. Intervallet för surrogattecken är #x10000 till #x10FFFF. Följande formel används för att generera surrogatteckenentiteten: (highChar - 0xD800) * 0x400 + (lowChar - 0xDC00) + . 0x10000

För både HTML och XML baseras dokumentteckenuppsättningen (och därmed notationen av numeriska teckenreferenser) på UCS [ISO-10646]. En referens för ett enskilt numeriskt tecken i ett källdokument kan därför i vissa fall motsvara två 16-bitarsenheter i en sträng (en hög surrogat och en låg surrogat). Dessa 16-bitarsenheter kallas surrogatpar.

Mer information om surrogater eller tecken finns i avsnitt 3.7 i Unicode 3.0/Unicode 2.0 standard eller avsnitt 2.2 i W3C XML 1.0-rekommendationen.

Gäller för