Tworzenie nowych odwołań do jednostek

Metoda CreateEntityReference tworzy nowy węzeł XmlEntityReference . Model obiektów dokumentów XML (DOM) sprawdza, czy nazwa jednostki, do których odwołuje się odwołanie, została już zadeklarowana. Jeśli tak, węzły podrzędne węzła XmlEntityReference są kopiowane z węzła deklaracji jednostki. Jeśli nie ma deklaracji jednostki zgodnej, pusty węzeł tekstowy jest dołączony jako jedyny element podrzędny węzła odwołania do jednostki. Ponieważ węzły podrzędne węzła XmlEntityReference są kopiami innych węzłów, te węzły podrzędne są tylko do odczytu i nie można ich modyfikować.

Podczas kopiowania węzłów może istnieć przestrzeń nazw w zakresie w punkcie odwołania do jednostki. Ta przestrzeń nazw ma wpływ na konfigurację dowolnego wygenerowanego elementu lub węzłów atrybutów.

Uwaga

Dom dodaje węzły podrzędne do elementu EntityReference tylko podczas wstawiania węzła EntityReference do dokumentu. Nowo utworzone węzły EntityReference nie mają węzłów podrzędnych.

Mimo że xmlDataDocument jest klasą pochodną xmlDocument, xmlDataDocument nie obsługuje tworzenia odwołań do jednostek. Dzieje się tak, ponieważ elementy podrzędne EntityReference są tylko do odczytu. Elementy podrzędne węzła EntityReference mogą obejmować więcej niż jeden region. W takim przypadku część wiersza skojarzona z regionem, który zawiera część elementu EntityReference , będzie tylko do odczytu.

Zobacz też

• Model DOM (XML Document Object Model)