XmlTextReader.EntityHandling Eigenschaft

  • Referenz

Definition

Namespace:
System.Xml
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Ruft einen Wert ab, der angibt, wie der Reader Entitäten behandelt, oder legt diesen fest.

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 EntityHandling nicht angegeben ist, wird als Standardwert EntityHandling.ExpandCharEntities verwendet.

Hinweise

Hinweis

Ab dem .NET Framework 2.0 empfehlen wir, Instanzen mithilfe der XmlReader.Create Methode zu erstellenXmlReader, 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, sollten Sie folgendes XML berücksichtigen:

<!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 festgelegt ist ExpandCharEntitiesund WhitespaceHandling auf oder Allfestgelegt Significant ist, erweitert das "doc"-Element die Zeichenentität und gibt die allgemeine Entität als Knoten zurück:

Tiefe Knotentyp Name Wert
1 Text Ein
1 EntityReference num
1 SignificantWhitespace

Gilt für

Siehe auch