XmlNode.BaseURI Vlastnost
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá základní identifikátor URI aktuálního uzlu.
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
Hodnota vlastnosti
Umístění, ze kterého byl uzel načten, nebo String.Empty, pokud uzel nemá žádný základní identifikátor URI.
Poznámky
Dokument XML v síti se skládá z bloků dat agregovaných pomocí různých standardních mechanismů zahrnutí W3C a proto obsahuje uzly, které pocházejí z různých míst. Řekne BaseURI vám, odkud tyto uzly pocházejí.
Hodnota této vlastnosti se liší v závislosti na typu uzlu. Uzly dokumentu například vrátí umístění objektu XmlDocument . Uzly, které jsou podřízenými uzly externích uzlů EntityReference, vrací umístění samotné entity. Představte si například následující dokument XML:
<!DOCTYPE item [
<!ENTITY xyz SYSTEM "a/b.xml">
]>
<item num='123'>&xyz;</item>
kde externí entita a/b.xml obsahuje text XML: <test>123</test>.
Pokud je dokument načten z http://server/mydata.xml, BaseURI vrátí následující:
| NodeType | název | Baseuri |
|---|---|---|
| Vlastnost | číslo | http://server/mydata.xml |
| Doklad | #document | http://server/mydata.xml |
| Typ dokumentu | položka | http://server/mydata.xml |
| Entita | Xyz | http://server/mydata.xml |
| prvek | položka | http://server/mydata.xml |
| EntityReference | Xyz | http://server/mydata.xml |
| prvek | test | http://server/a/b.xml |
| Text | #text | http://server/a/b.xml |
BaseURI hledá hranice odkazu na entity, takže pokud entity jsou rozbalené tyto informace nejsou zachovány a tato vlastnost vrátí umístění objektu XmlDocument ve všech případech.
Jako druhý příklad je uveden následující dokument XML:
<!DOCTYPE Mydata SYSTEM "http://localhost/doctype.dtd">
<baa>&xyz;</baa>
Kde soubor DTD obsahuje následující:
<!ENTITY xyz <E1>My Data</E1>
<!ELEMENT baa #PCDATA>
<!ATTLIST baa attr1 "woof">
Pokud je dokument XML načten z http://localhost/mydata.xml, BaseURI vrátí následující položky pro každý z uzlů:
| NodeType | název | Baseuri |
|---|---|---|
| Doklad | #document | http://localhost/mydata.xml |
| Typ dokumentu | Mydata | http://localhost/mydata.xmlPomocí XmlDocumentType.SystemId vlastností XmlDocumentType.PublicId lze identifikovat, odkud byl načten soubor DTD. |
| prvek | Baa | http://localhost/mydata.xml |
| Entita | Xyz | http://localhost/doctype.dtd |
| EntityReference | Xyz | http://localhost/mydata.xml |
| Vlastnost | Haf | http://localhost/mydata.xml |
Poznámka:
Základní identifikátor URI výchozího atributu je stejný jako základní identifikátor URI elementu, do kterého patří.
Tato vlastnost je rozšířením Microsoftu pro model DOM (Document Object Model).