XmlTextReader.EntityHandling Eigenschaft

Definition

Namespace:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Quelle:

XmlTextReader.cs

Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie der Leser Entitäten behandelt.

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

Eigenschaftswert

EntityHandling

Einer der EntityHandling Werte. Wenn kein EntityHandling Wert angegeben ist, wird standardmäßig auf EntityHandling.ExpandCharEntities.

Hinweise

Hinweis

Es wird empfohlen, XmlReader-Instanzen mithilfe der XmlReader.Create-Methode zu erstellen, um neue Funktionen zu nutzen.

Diese Eigenschaft kann im Flug geändert werden und wird nach dem nächsten Read Aufruf wirksam.

Wenn EntityHandling dieser Wert auf ExpandCharEntities"Attributwerte" festgelegt ist, werden attributwerte nur teilweise normalisiert. Der Leser normalisiert jeden einzelnen Textknoten unabhängig vom Inhalt benachbarter Entitätsverweisknoten.

Um den Unterschied zwischen den Entitätsbehandlungsmodi zu veranschaulichen, berücksichtigen Sie folgendes XML:

<!DOCTYPE doc [<!ENTITY num "123">]>
    <doc> &#65; &num; </doc>

Wenn EntityHandling auf ExpandEntities den Elementknoten "doc" festgelegt ist, enthält einen Textknoten mit dem erweiterten Entitätstext:

Tiefe	Knotentyp	Name	Wert
1	Text		A 123

Wenn EntityHandling das Element auf ExpandCharEntitiesSignificantAlloder auf "doc" festgelegt ist, WhitespaceHandling wird die Zeichenentität erweitert und die allgemeine Entität als Knoten zurückgegeben:

Tiefe	Knotentyp	Name	Wert
1	Text		A
1	EntityReference	Zahl
1	SignificantWhitespace

Weitere Informationen

• XmlReader