XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Genererar och skriver surrogatteckenentiteten för surrogatteckenparet.
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)
Parametrar
- lowChar
- Char
Den låga surrogatmamman. Detta måste vara ett värde mellan 0xDC00 och 0xDFFF.
- highChar
- Char
Den höga surrogaten. Detta måste vara ett värde mellan 0xD800 och 0xDBFF.
Undantag
Ett ogiltigt surrogatteckenpar skickades.
Kommentarer
Note
Vi rekommenderar att du skapar XmlWriter instanser med hjälp av XmlWriter.Create metoden och XmlWriterSettings klassen för att dra nytta av den nya funktionaliteten.
Den här metoden gäller endast för system som använder UTF-16-kodning.
Entiteten surrogattecken är skriven i hexadecimalt format. Intervallet för surrogattecken är #x10000 till #x10FFFF. Följande formel används för att generera surrogatteckenentiteten: (highChar - 0xD800) * 0x400 + (lowChar - 0xDC00) + . 0x10000
För både HTML och XML baseras dokumentteckenuppsättningen (och därmed notationen av numeriska teckenreferenser) på UCS [ISO-10646]. En referens för ett enskilt numeriskt tecken i ett källdokument kan därför i vissa fall motsvara två 16-bitarsenheter i en sträng (en hög surrogat och en låg surrogat). Dessa 16-bitarsenheter kallas surrogatpar.
Mer information om surrogater eller tecken finns i avsnitt 3.7 i Unicode 3.0/Unicode 2.0 standard eller avsnitt 2.2 i W3C XML 1.0-rekommendationen.