XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Metoda

Definice

Obor názvů:

System.Xml

Sestavení:

System.Xml.ReaderWriter.dll

Sestavení:

System.Xml.dll

Sestavení:

netstandard.dll

Vygeneruje a zapíše náhradní znak entitu pro náhradní dvojici znaků.

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)

Parametry

lowChar

Char

Nízký náhradník. 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

Exception

Byl předán neplatný náhradní pár znaků.

Poznámky

Poznámka

Počínaje verzí .NET Framework 2.0 doporučujeme vytvářet XmlWriter instance pomocí XmlWriter.Create metody a XmlWriterSettings třídy, abyste mohli využívat nové funkce.

Tato metoda se vztahuje pouze na systémy, 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 na #x10FFFF. Následující vzorec slouží k vygenerování náhradní znakové entity: () * + (highChar``lowChar - 0xDC00``0xD800 - ) + . 0x10000``0x400

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 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 týkající se náhradních nebo znaků najdete v části 3.7 standardu Unicode 3.0/Unicode 2.0 nebo v části 2.2 doporučení W3C XML 1.0.