XmlEntity.BaseURI Свойство

Определение

Пространство имен:

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Сборка:

System.Xml.dll

Сборка:

netstandard.dll

Получает базовый универсальный код ресурса (URI) текущего узла.

public:
 virtual property System::String ^ BaseURI { System::String ^ get(); };

public override string BaseURI { get; }

member this.BaseURI : string

Public Overrides ReadOnly Property BaseURI As String

Значение свойства

String

Расположение, из которого загружен узел.

Комментарии

Сетевой XML-документ состоит из блоков данных, агрегированных с помощью различных стандартных механизмов включения консорциума W3C и поэтому содержит узлы, поступающие из разных мест. Указывает BaseURI , откуда пришли эти узлы.

Значение этого свойства зависит от типа узла. Узлы, являющиеся дочерними элементами внешних узлов EntityReference, возвращают расположение самой сущности. Например, рассмотрим следующий XML-документ:

<!DOCTYPE item [  
<!ENTITY xyz SYSTEM "a/b.xml">  
]>  
<item num='123'>&xyz;</item>  

где внешняя сущность a/b.xml содержит XML-текст <test>123</test>.

Если документ загружается из http://server/mydata.xml, BaseURI возвращает следующее:

NodeType	Имя	Baseuri
attribute	num	http://server/mydata.xml
Документ	#document	http://server/mydata.xml
DocumentType;	item	http://server/mydata.xml
Сущность	xyz	http://server/mydata.xml
Элемент	item	http://server/mydata.xml
EntityReference	xyz	http://server/mydata.xml
Элемент	номер	http://server/a/b.xml
Текст	#text	http://server/a/b.xml

BaseURI ищет границы ссылок на сущности, поэтому если сущности развернуты, эти сведения не сохраняются, и это свойство возвращает расположение XmlDocument объекта во всех случаях.

В качестве второго примера, учитывая следующий XML-документ:

<!DOCTYPE Mydata SYSTEM "http://localhost/doctype.dtd">  
<baa>&xyz;</baa>  

где файл определения типа документа (DTD) содержит следующее:

<!ENTITY xyz "<E1>My Data</E1>">  
<!ELEMENT baa #PCDATA>  
<!ATTLIST baa attr1 "woof">  

Если XML-документ загружается из http://localhost/mydata.xml, BaseURI возвращает следующие значения для каждого узла:

NodeType	Имя	Baseuri
Документ	#document	http://localhost/mydata.xml
DocumentType;	Mydata	http://localhost/doctype.dtd
Элемент	Баа	http://localhost/mydata.xml
Сущность	xyz	http://localhost/doctype.dtd
EntityReference	xyz	http://localhost/mydata.xml
attribute	Гав	http://localhost/mydata.xml

Примечание

Базовый URI атрибута по умолчанию совпадает с базовым универсальным кодом ресурса (URI) элемента, к которому они принадлежат.

Это свойство является расширением Microsoft для объектной модели документа (DOM).