Udostępnij przez

Tworzenie nowych odwołań do jednostek

Metoda CreateEntityReference tworzy nowy węzeł XmlEntityReference . Model obiektów dokumentów XML (DOM) sprawdza, czy nazwa encji, na którą się odwołuje, 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 brak jest odpowiedniej deklaracji obiektu, pusty węzeł tekstowy jest dołączany jako jedyne dziecko węzła odwołania do obiektu. 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 w miejscu odniesienia do jednostki może istnieć przestrzeń nazw w zakresie. Ta przestrzeń nazw ma wpływ na konfigurację dowolnego wygenerowanego elementu lub węzłów atrybutów.

Uwaga / Notatka

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 także

  • Last updated on