XmlTextReader.EntityHandling Eigenschap
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.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft hoe de lezer entiteiten verwerkt.
public:
property System::Xml::EntityHandling EntityHandling { System::Xml::EntityHandling get(); void set(System::Xml::EntityHandling value); };public System.Xml.EntityHandling EntityHandling { get; set; }member this.EntityHandling : System.Xml.EntityHandling with get, setPublic Property EntityHandling As EntityHandlingWaarde van eigenschap
Een van de EntityHandling waarden. Als er geen EntityHandling is opgegeven, wordt deze standaard ingesteld op EntityHandling.ExpandCharEntities.
Opmerkingen
Note
Wij raden aan dat u XmlReader instanties maakt met behulp van de XmlReader.Create methode om te profiteren van nieuwe functionaliteiten.
Deze eigenschap kan snel worden gewijzigd en wordt van kracht na de volgende Read aanroep.
Wanneer EntityHandling deze waarde is ingesteld ExpandCharEntities, worden kenmerkwaarden slechts gedeeltelijk genormaliseerd. De lezer normaliseert elk afzonderlijk tekstknooppunt onafhankelijk van de inhoud van aangrenzende entiteitsreferentieknooppunten.
Bekijk de volgende XML om het verschil tussen de entiteitsafhandelingsmodi te illustreren:
<!DOCTYPE doc [<!ENTITY num "123">]>
<doc> A # </doc>
Wanneer EntityHandling het elementknooppunt Doc is ingesteld ExpandEntities , bevat één tekstknooppunt met de uitgebreide entiteitstekst:
| Diepte | Knooppunttype | Naam | Waarde |
|---|---|---|---|
| 1 | Text |
A 123 |
Wanneer EntityHandling dit is ingesteld op ExpandCharEntities, en WhitespaceHandling is ingesteld op Significant of All, wordt het element 'doc' de tekenentiteit uitgebreid en wordt de algemene entiteit geretourneerd als een knooppunt:
| Diepte | Knooppunttype | Naam | Waarde |
|---|---|---|---|
| 1 | Text |
A | |
| 1 | EntityReference |
num | |
| 1 | SignificantWhitespace |
