XmlTextReader.EntityHandling Eigenschap

Definitie

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, set
Public Property EntityHandling As EntityHandling

Waarde 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> &#65; &num; </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

Van toepassing op

Zie ook