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 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 -> unitPublic 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
È 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.