XmlWriter.WriteSurrogateCharEntity(Char, Char) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

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

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áhradník. Musí to být hodnota mezi 0xDC00 a 0xDFFF.

highChar

Char

Vysoká náhrada. Musí se jednat o hodnotu mezi 0xD800 a 0xDBFF.

Výjimky

ArgumentException

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

InvalidOperationException

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

Poznámky

Tato metoda je použitelná pouze v systémech, které používají kódování UTF-16.

Náhradní entita znaku je zapsána v šestnáctkovém formátu. Rozsah náhradních znaků je #x10000 #x10FFFF. Následující vzorec slouží k vygenerová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]. Odkaz na jeden číselný znak ve zdrojovém dokumentu proto může v některých případech odpovídat dvěma 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 znacích nebo znacích najdete v části 3.7 standardu Unicode 3.0/Unicode 2.0 umístěného v https://www.unicode.orgčásti 2.2 doporučení W3C XML 1.0.

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