XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Genera e scrive l'entità carattere surrogata per la coppia di caratteri surrogati.

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)

Parametri

lowChar

Char

Surrogato basso. Questo valore deve essere compreso tra 0xDC00 e 0xDFFF.

highChar

Char

Surrogato alto. Questo valore deve essere compreso tra 0xD800 e 0xDBFF.

Eccezioni

Exception

È stata passata una coppia di caratteri surrogati non valida.

Commenti

Nota

A partire dalla .NET Framework 2.0, è consigliabile creare XmlWriter istanze usando il metodo e la XmlWriter.Create XmlWriterSettings classe per sfruttare le nuove funzionalità.

Questo metodo è applicabile solo nei sistemi che usano la codifica UTF-16.

L'entità carattere surrogato viene scritta in formato esadecimale. L'intervallo per i caratteri surrogati è #x10000 di #x10FFFF. La formula seguente viene usata per generare l'entità carattere surrogato: () * + 0x400 (lowChar``highChar``0xD800 - - 0xDC00) + . 0x10000

Per HTML e XML, il set di caratteri del documento (e quindi la notazione dei riferimenti numerici dei caratteri) è basato su UCS [ISO-10646]. Un singolo riferimento numerico di carattere in un documento di origine può quindi corrispondere a due unità a 16 bit in una stringa (un surrogato elevato e un surrogato basso). Queste unità a 16 bit vengono definite coppia surrogata.

Per altre informazioni sui surrogati o i caratteri, vedere la sezione 3.7 dello standard Unicode 3.0/Unicode 2.0 o sezione 2.2 della raccomandazione XML W3C XML 1.0.