XmlWriter.WriteSurrogateCharEntity(Char, Char) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

netstandard.dll, System.Xml.ReaderWriter.dll

Zdroj:

XmlWriter.cs

Při přepsání v odvozené třídě vygeneruje a zapíše náhradní znak entitu pro dvojici náhradních znaků.

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)

Parametry

lowChar

Char

Nízká náhrada. Musí to být hodnota mezi 0xDC00 a 0xDFFF.

highChar

Char

Vysoký náhradník. Musí to být hodnota mezi 0xD800 a 0xDBFF.

Výjimky

ArgumentException

Byla předána neplatná dvojice náhradních znaků.

InvalidOperationException

Před XmlWriter dokončením předchozí asynchronní operace byla volána metoda. V tomto případě InvalidOperationException je vyvolán zpráva "Asynchronní operace už probíhá".

Poznámky

Tato metoda se vztahuje pouze na systémy, které používají kódování UTF-16.

Náhradní znaková entita je napsána v šestnáctkovém formátu. Rozsah náhradních znaků je #x10000 #x10FFFF. Následující vzorec slouží ke generování náhradní znakové entity: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000

Pro HTML i XML je znaková sada dokumentu (a proto zápis číselných znaků) založen na UCS [ISO-10646]. Jeden odkaz na číselný znak ve zdrojovém dokumentu proto může v některých případech odpovídat 16bitovým jednotkám v řetězci (vysoké náhradní a nízké náhradní). Tyto 16bitové jednotky se označují jako náhradní dvojice.

Další informace o náhradních nebo znacích najdete v části 3.7 standardu Unicode 3.0/Unicode 2.0 umístěném v https://www.unicode.orgdoporučení w3C XML 1.0 nebo v části 2.2.

Asynchronní verzi této metody naleznete v tématu WriteSurrogateCharEntityAsync.