XmlValidatingReader.EntityHandling Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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, setPublic Property EntityHandling As EntityHandlingEigenschaftswert
Einer der EntityHandling Werte. Wenn kein EntityHandling Wert angegeben ist, wird "EntityHandling.ExpandEntities" standardmäßig verwendet.
Ausnahmen
Es wurde ein ungültiger Wert angegeben.
Hinweise
Hinweis
Die XmlValidatingReader Klasse ist in .NET Framework 2.0 veraltet. Sie können eine Überprüfungsinstanz XmlReader mithilfe der XmlReaderSettings Klasse und der Create Methode erstellen. Weitere Informationen finden Sie im Abschnitt Hinweise auf der XmlReader Referenzseite.
Diese Eigenschaft kann 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> A # </doc>
Wenn EntityHandling auf ExpandEntities den Elementknoten "doc" festgelegt ist, enthält einen Textknoten mit dem erweiterten Entitätstext:
| Tiefe | NodeType | Name | Wert |
|---|---|---|---|
| 1 | Text | A 123 |
Wenn EntityHandling dieser Wert auf "ExpandCharEntitiesWhitespaceHandlingRelevant" oder "All" festgelegt ist, erweitert das "doc"-Element die Zeichenentität und gibt die allgemeine Entität als Knoten zurück:
| Tiefe | NodeType | Name | Wert |
|---|---|---|---|
| 1 | Text | A | |
| 1 | EntityReference | Zahl | |
| 1 | Signifikantes Leerzeichen |
