XmlEntity.BaseURI Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém o Identificador Uniforme de Recursos (URI) 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 de Propriedade
O local de onde o nó foi carregado.
Observações
Um documento XML em rede é composto por blocos de dados agregados usando vários mecanismos de inclusão padrão do World Wide Web Consortium (W3C) e, por isso, contém nós provenientes de diferentes locais. Diz-te BaseURI de onde vieram esses nós.
O valor desta propriedade varia consoante o tipo de nó. Nós que são filhos de nós externos EntityReference retornam a localização 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 a partir de http://server/mydata.xml, BaseURI retorna o seguinte:
| NodeType | Name | BaseURI |
|---|---|---|
| Attribute | número | http://server/mydata.xml |
| Documento | #document | http://server/mydata.xml |
| Tipo de documento | item | http://server/mydata.xml |
| Entity | xyz | http://server/mydata.xml |
| Elemento | item | http://server/mydata.xml |
| EntityReference | xyz | http://server/mydata.xml |
| Elemento | testar | http://server/a/b.xml |
| Texto | #text | http://server/a/b.xml |
BaseURI procura limites de referência de entidade, por isso, se as entidades forem expandidas, esta informação não é preservada e esta propriedade devolve a localização 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>
onde o ficheiro de definição de tipo de documento (DTD) contém o seguinte:
<!ENTITY xyz "<E1>My Data</E1>">
<!ELEMENT baa #PCDATA>
<!ATTLIST baa attr1 "woof">
Se o documento XML for carregado a partir de http://localhost/mydata.xml, BaseURI retorna o seguinte para cada um dos nós:
| NodeType | Name | BaseURI |
|---|---|---|
| Documento | #document | http://localhost/mydata.xml |
| Tipo de documento | Mydata | http://localhost/doctype.dtd |
| Elemento | baa | http://localhost/mydata.xml |
| Entity | xyz | http://localhost/doctype.dtd |
| EntityReference | xyz | http://localhost/mydata.xml |
| Attribute | au au | http://localhost/mydata.xml |
Note
O URI base de um atributo padrão é o mesmo que o URI base do elemento ao qual pertencem.
Esta propriedade é uma extensão da Microsoft para o Modelo de Objetos do Documento (DOM).