XmlNode.BaseURI Propriété

Définition

Espace de noms:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Source:

XmlNode.cs

Obtient l’URI de base du nœud actuel.

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

public virtual string BaseURI { get; }

member this.BaseURI : string

Public Overridable ReadOnly Property BaseURI As String

Valeur de propriété

String

Emplacement à partir duquel le nœud a été chargé ou String.Empty si le nœud n’a pas d’URI de base.

Remarques

Un document XML en réseau est composé de blocs de données agrégées à l’aide de différents mécanismes d’inclusion standard W3C et contient donc des nœuds provenant de différents emplacements. Vous BaseURI indique à quel endroit ces nœuds proviennent.

La valeur de cette propriété varie en fonction du type de nœud. Par exemple, les nœuds document retournent l’emplacement de l’objet XmlDocument . Les nœuds 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 XML : <test>123</test>.

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

NodeType	Nom	Baseuri
Caractéristique	nombre	http://server/mydata.xml
Document	#document	http://server/mydata.xml
DocumentType	item	http://server/mydata.xml
Entité	Xyz	http://server/mydata.xml
Élément	item	http://server/mydata.xml
Référence d'entité	Xyz	http://server/mydata.xml
Élément	test	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 les 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 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	Nom	Baseuri
Document	#document	http://localhost/mydata.xml
DocumentType	Mydata	http://localhost/mydata.xml XmlDocumentType.PublicId Les XmlDocumentType.SystemId propriétés peuvent être utilisées pour identifier l’emplacement à partir duquel le fichier DTD a été chargé.
Élément	Baa	http://localhost/mydata.xml
Entité	Xyz	http://localhost/doctype.dtd
Référence d'entité	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).