XmlNode.BaseURI Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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 constitué 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. Le BaseURI
message vous indique l’origine de ces nœuds.
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 |
---|---|---|
Attribut | num | 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 |
EntityReference | xyz | http://server/mydata.xml |
Élément | test | http://server/a/b.xml |
Texte | #text | http://server/a/b.xml |
BaseURI
recherche des 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 ce qui suit pour chacun des nœuds :
NodeType | Nom | Baseuri |
---|---|---|
Document | #document | http://localhost/mydata.xml |
DocumentType ; | Mydata | http://localhost/mydata.xml Vous pouvez utiliser ou XmlDocumentType.SystemId XmlDocumentType.PublicId les propriétés 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 |
EntityReference | xyz | http://localhost/mydata.xml |
Attribut | Woof | http://localhost/mydata.xml |
Notes
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 du modèle DOM (Document Object Model).