Freigeben über

XmlTextReader.EntityHandling Eigenschaft

Definition

Namespace:
System.Xml
Assemblys:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
Quelle:
XmlTextReader.cs
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

Gilt für:

Weitere Informationen