XmlWriter.WriteSurrogateCharEntity(Char, Char) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Wanneer deze wordt overschreven in een afgeleide klasse, genereert en schrijft u de surrogaattekenentiteit voor het surrogaattekenpaar.
public:
abstract void WriteSurrogateCharEntity(char lowChar, char highChar);public abstract void WriteSurrogateCharEntity(char lowChar, char highChar);abstract member WriteSurrogateCharEntity : char * char -> unitPublic MustOverride Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)Parameters
- lowChar
- Char
Het lage surrogaat. Dit moet een waarde zijn tussen 0xDC00 en 0xDFFF.
- highChar
- Char
De hoge surrogaat. Dit moet een waarde zijn tussen 0xD800 en 0xDBFF.
Uitzonderingen
Er is een ongeldig surrogaattekenpaar doorgegeven.
Er XmlWriter is een methode aangeroepen voordat een vorige asynchrone bewerking is voltooid. In dit geval InvalidOperationException wordt het bericht 'Er wordt al een asynchrone bewerking uitgevoerd'.
Opmerkingen
Deze methode is alleen van toepassing op systemen die gebruikmaken van UTF-16-codering.
De surrogaattekenentiteit is geschreven in hexadecimale indeling. Het bereik voor surrogaattekens wordt #x10000 tot #x10FFFF. De volgende formule wordt gebruikt om de entiteit surrogaatteken te genereren: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000
Voor zowel HTML als XML is de documenttekenset (en daarom de notatie van numerieke tekenverwijzingen) gebaseerd op UCS [ISO-10646]. Een verwijzing naar één numeriek teken in een brondocument kan daarom in sommige gevallen overeenkomen met twee 16-bits eenheden in een tekenreeks (een hoog surrogaat en een laag surrogaat). Deze 16-bits eenheden worden een surrogaatpaar genoemd.
Raadpleeg sectie 3.7 van de Standaard Unicode 3.0/Unicode 2.0 in https://www.unicode.orgof sectie 2.2 van de W3C XML 1.0-aanbeveling voor meer informatie over surrogaten of tekens.
Zie voor de asynchrone versie van deze methode WriteSurrogateCharEntityAsync.
