XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Metodo

Definizione

Genera e scrive l'entità carattere surrogata per la coppia di caratteri surrogati.Generates and writes the surrogate character entity for the surrogate character pair.

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.The low surrogate. Questo valore deve essere compreso tra 0xDC00 e 0xDFFF.This must be a value between 0xDC00 and 0xDFFF.

highChar
Char

Surrogato alto.The high surrogate. Questo valore deve essere compreso tra 0xD800 e 0xDBFF.This must be a value between 0xD800 and 0xDBFF.

Eccezioni

È stata passata una coppia di caratteri surrogati non valida.An invalid surrogate character pair was passed.

Commenti

Nota

A partire da .NET Framework 2,0, è consigliabile creare XmlWriter istanze usando il XmlWriter.Create metodo e la XmlWriterSettings classe per sfruttare le nuove funzionalità.Starting with the .NET Framework 2.0, we recommend that you create XmlWriter instances by using the XmlWriter.Create method and the XmlWriterSettings class to take advantage of new functionality.

Questo metodo è applicabile solo nei sistemi che utilizzano la codifica UTF-16.This method is only applicable on systems that use UTF-16 encoding.

L'entità di caratteri surrogati viene scritta in formato esadecimale.The surrogate character entity is written in hexadecimal format. L'intervallo per i caratteri #x10000 surrogati #x10FFFFè.The range for surrogate characters is #x10000 to #x10FFFF. La formula seguente viene usata per generare l'entità di caratteri surrogatihighChar: ( 0x400 0xDC00 - - 0xD800) *lowChar+ ( 0x10000) +.The following formula is used to generate the surrogate character entity: (highChar - 0xD800) * 0x400 + (lowChar - 0xDC00) + 0x10000.

Per HTML e XML, il set di caratteri del documento (e pertanto la notazione dei riferimenti a caratteri numerici) è basato su UCS [ISO-10646].For both HTML and XML, the document character set (and therefore the notation of numeric character references) is based on UCS [ISO-10646]. Un singolo riferimento a un carattere numerico in un documento di origine può quindi, in alcuni casi, corrispondere a unità a 2 16 bit in una stringa (un surrogato alto e un surrogato basso).A single numeric character reference in a source document may therefore in some cases correspond to two 16-bit units in a string (a high surrogate and a low surrogate). Queste unità a 16 bit sono denominate coppie di surrogati.These 16-bit units are referred to as a surrogate pair.

Per ulteriori informazioni sui surrogati o sui caratteri, vedere la sezione 3,7 dello standard Unicode 3.0/unicode 2,0o la sezione 2,2 della raccomandazione W3C XML 1,0.For more information regarding surrogates or characters, refer to section 3.7 of the Unicode 3.0/Unicode 2.0 standard, or section 2.2 of the W3C XML 1.0 Recommendation.

Si applica a