Freigeben über

Erstellen neuer Entitätsverweise

Die CreateEntityReference-Methode erstellt einen neuen XmlEntityReference-Knoten . Das XML Document Object Model (DOM) sucht, ob der Entitätsname, auf den verwiesen wird, bereits deklariert wurde. Wenn dies der Fall ist, werden die untergeordneten Knoten des XmlEntityReference-Knotens aus dem Entitätsdeklarationsknoten kopiert. Wenn keine Entitätsdeklaration vorhanden ist, die übereinstimmt, wird ein leerer Textknoten als einziges untergeordnetes Element des Entitätsverweisknotens angefügt. Da es sich bei den untergeordneten Knoten des XmlEntityReference-Knotens um Kopien anderer Knoten handelt, sind diese Knoten schreibgeschützt und können nicht geändert werden.

Wenn die Knoten kopiert werden, kann ein Namespace im Gültigkeitsbereich an der Position des Entitätsverweises vorhanden sein. Dieser Namespace wirkt sich auf die Konfiguration aller generierten Element- oder Attributknoten aus.

Hinweis

Das DOM fügt dem EntityReference-Objekt nur untergeordnete Knoten hinzu, wenn Sie den EntityReference-Knoten in das Dokument einfügen. Neu erstellte EntityReference-Knoten weisen keine untergeordneten Knoten auf.

Obwohl das XmlDataDocument eine abgeleitete Klasse von XmlDocument ist, unterstützt das XmlDataDocument nicht die Erstellung von Entitätsverweisen. Dies liegt daran, dass untergeordnete Elemente von EntityReference schreibgeschützt sind. Die untergeordneten Knoten eines EntityReference-Knotens können mehr als eine Region umfassen. In diesem Fall ist der Teil einer Zeile schreibgeschützt, der mit der Region mit einem Teil einer EntityReference verknüpft ist.

Siehe auch

  • Last updated on