XmlEntity.BaseURI Propriedade

Definição

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).

Aplica-se a