XmlEntity.BaseURI Propriedade

Definição

Namespace:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Obtém o URI (Uniform Resource Identifier) base do nó atual.

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

Valor da propriedade

String

O local do qual o nó foi carregado.

Comentários

Um documento XML em rede é composto por partes de dados agregados usando vários mecanismos de inclusão padrão do W3C (World Wide Web Consortium) e, portanto, contém nós provenientes de locais diferentes. Dizem BaseURI de onde vieram esses nós.

O valor dessa propriedade varia dependendo do tipo de nó. Nós que são filhos de nós EntityReference externos retornam o local da própria entidade. Por exemplo, considere o seguinte documento XML:

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

onde a entidade a/b.xml externa contém o texto <test>123</test>XML.

Se o documento for carregado http://server/mydata.xml, BaseURI retornará o seguinte:

NodeType	Nome	Baseuri
Atributo	num	http://server/mydata.xml
Documento	#document	http://server/mydata.xml
DocumentType	item	http://server/mydata.xml
Entidade	xyz	http://server/mydata.xml
Elemento	item	http://server/mydata.xml
EntityReference	xyz	http://server/mydata.xml
Elemento	test	http://server/a/b.xml
Texto	#text	http://server/a/b.xml

BaseURI procura limites de referência de entidade, portanto, se as entidades forem expandidas, essas informações não serão preservadas e essa propriedade retornará o local do XmlDocument objeto em todos os casos.

Como segundo exemplo, dado o seguinte documento XML:

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

em que o arquivo DTD (definição de tipo de documento) contém o seguinte:

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

Se o documento XML for carregado http://localhost/mydata.xml, BaseURI retornará o seguinte para cada um dos nós:

NodeType	Nome	Baseuri
Documento	#document	http://localhost/mydata.xml
DocumentType	Mydata	http://localhost/doctype.dtd
Elemento	Baa	http://localhost/mydata.xml
Entidade	xyz	http://localhost/doctype.dtd
EntityReference	xyz	http://localhost/mydata.xml
Atributo	Woof	http://localhost/mydata.xml

Observação

O URI base de um atributo padrão é o mesmo que o URI base do elemento ao qual eles pertencem.

Essa propriedade é uma extensão da Microsoft do DOM (Modelo de Objeto do Documento).