XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Genera e scrive l'entità carattere surrogato 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 -> unitPublic Overrides Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)Parametri
- lowChar
- Char
Surrogato basso. Deve essere un valore compreso tra 0xDC00 e 0xDFFF.
- highChar
- Char
Surrogato alto. Deve essere un valore compreso tra 0xD800 e 0xDBFF.
Eccezioni
È stata passata una coppia di caratteri surrogati non valida.
Commenti
Note
È consigliabile creare XmlWriter istanze usando il XmlWriter.Create metodo e la 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 .#x10FFFF La formula seguente viene usata per generare l'entità carattere surrogato: (highChar - 0xD800) * 0x400 + (lowChar - 0xDC00) + . 0x10000
Sia per HTML che per XML, il set di caratteri del documento (e quindi la notazione di riferimenti a caratteri numerici) è basato su UCS [ISO-10646]. Un singolo riferimento numerico a caratteri in un documento di origine può pertanto corrispondere in alcuni casi a due unità a 16 bit in una stringa (surrogato elevato e surrogato basso). Queste unità a 16 bit vengono definite coppie di surrogati.
Per altre informazioni sui surrogati o sui caratteri, vedere la sezione 3.7 dello standard Unicode 3.0/Unicode 2.0 o la sezione 2.2 della raccomandazione W3C XML 1.0.
