XmlWriter.WriteSurrogateCharEntity(Char, Char) Metod

Definition

Namnområde:
System.Xml
Sammansättningar:
System.Xml.dll, System.Xml.ReaderWriter.dll
Sammansättningar:
netstandard.dll, System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.ReaderWriter.dll
Sammansättning:
System.Xml.dll
Sammansättning:
netstandard.dll
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs
Källa:
XmlWriter.cs

När den åsidosättas i en härledd klass genererar och skriver du surrogatteckenentiteten för surrogatteckenparet.

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)

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

ArgumentException

Ett ogiltigt surrogatteckenpar skickades.

InvalidOperationException

En XmlWriter metod anropades innan en tidigare asynkron åtgärd slutfördes. I det här fallet InvalidOperationException genereras meddelandet "En asynkron åtgärd pågår redan".

Kommentarer

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 att #x10FFFF. Följande formel används för att generera entiteten surrogattecken: (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-standarden som finns på https://www.unicode.org, eller avsnitt 2.2 i W3C XML 1.0-rekommendationen.

Den asynkrona versionen av den här metoden finns i WriteSurrogateCharEntityAsync.

Gäller för