Yeni Varlık Referansları Oluşturma

CreateEntityReference yöntemi yeni bir XmlEntityReference düğümü oluşturur. XML Belgesi Nesne Modeli (DOM), başvurulmakta olan varlık adının önceden bildirilip bildirilmediğini denetler. Varsa, XmlEntityReference düğümünün alt düğümleri varlık bildirimi düğümünden kopyalanır. Eşleşen bir varlık bildirimi yoksa, boş bir metin düğümü varlık başvuru düğümünün tek alt öğesi olarak eklenir. XmlEntityReference düğümünün alt düğümleri diğer düğümlerin kopyaları olduğundan, bu alt düğümler salt okunur olur ve değiştirilemez.

Düğümler kopyalandığında, varlık referansı noktasında kapsamda bir ad alanı olabilir. Bu ad alanı, oluşturulan tüm öğe veya öznitelik düğümlerinin yapılandırmasını etkiler.

Uyarı

DOM, EntityReference düğümünü belgeye eklediğinizde EntityReference'a alt düğümleri ekler. Yeni oluşturulan EntityReference düğümlerinin alt düğümü yok.

XmlDataDocument, XmlDocument'ın türetilmiş bir sınıfı olsa da, XmlDataDocument varlık başvurularının oluşturulmasını desteklemez. Bunun nedeni EntityReference alt öğelerinin salt okunur olmasıdır. EntityReference düğümünün alt öğeleri birden fazla bölgeye yayılabilir. Bu durumda, EntityReference öğesinin bir bölümünü içeren bölgeyle ilişkilendirilmiş bir satırın bir bölümü salt okunur hale gelir.

Ayrıca bakınız

• XML Belgesi Nesne Modeli (DOM)