XmlEntity.BaseURI Propriété

Définition

Obtient l’URI (Uniform Resource Identifier) de base du nœud actuel.

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

Valeur de propriété

Emplacement à partir duquel le nœud a été chargé.

Remarques

Un document XML en réseau comprend des blocs de données agrégés à l’aide de différents mécanismes d’inclusion standard W3C (World Wide Web Consortium) et contient donc des nœuds provenant de différents endroits. Vous BaseURI indique à quel endroit ces nœuds proviennent.

La valeur de cette propriété varie en fonction du type de nœud. Les nœuds qui sont des enfants des nœuds EntityReference externes retournent l’emplacement de l’entité elle-même. Par exemple, considérez le document XML suivant :

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

où l’entité a/b.xml externe contient le texte <test>123</test>XML .

Si le document est chargé à partir de http://server/mydata.xml, BaseURI retourne ce qui suit :

NodeType Name Baseuri
Caractéristique nombre http://server/mydata.xml
Document #document http://server/mydata.xml
Type de document item http://server/mydata.xml
Entité Xyz http://server/mydata.xml
Élément item http://server/mydata.xml
EntityReference Xyz http://server/mydata.xml
Élément essai http://server/a/b.xml
Texte #text http://server/a/b.xml

BaseURI recherche les limites de référence d’entité. Par conséquent, si des entités sont développées, ces informations ne sont pas conservées et cette propriété retourne l’emplacement de l’objet XmlDocument dans tous les cas.

En guise de deuxième exemple, étant donné le document XML suivant :

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

où le fichier DTD (Document Type Definition) contient les éléments suivants :

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

Si le document XML est chargé à partir de http://localhost/mydata.xml, BaseURI retourne les éléments suivants pour chacun des nœuds :

NodeType Name Baseuri
Document #document http://localhost/mydata.xml
Type de document Mydata http://localhost/doctype.dtd
Élément Baa http://localhost/mydata.xml
Entité Xyz http://localhost/doctype.dtd
EntityReference Xyz http://localhost/mydata.xml
Caractéristique Woof http://localhost/mydata.xml

Note

L’URI de base d’un attribut par défaut est identique à l’URI de base de l’élément auquel ils appartiennent.

Cette propriété est une extension Microsoft au modèle DOM (Document Object Model).

S’applique à