Freigeben über


XmlNode.BaseURI-Eigenschaft

Ruft den Basis-URI des aktuellen Knotens ab.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

Syntax

'Declaration
Public Overridable ReadOnly Property BaseURI As String
'Usage
Dim instance As XmlNode
Dim value As String

value = instance.BaseURI
public virtual string BaseURI { get; }
public:
virtual property String^ BaseURI {
    String^ get ();
}
/** @property */
public String get_BaseURI ()
public function get BaseURI () : String

Eigenschaftenwert

Die Position, aus der der Knoten geladen wurde oder String.Empty, wenn der Knoten über keinen Basis-URI verfügt.

Hinweise

Ein Netzwerk-XML-Dokument besteht aus Datensegmenten, die unter Verwendung verschiedener vom W3C standardisierten Einschlussmechanismen zusammengesetzt werden. Folglich enthält es Knoten aus unterschiedlichen Quellen. Der BaseURI gibt die Quelle dieser Knoten an.

Der Wert dieser Eigenschaft hängt vom Knotentyp ab. Document-Knoten geben z. B. die Position des XmlDocument-Objekts zurück. Knoten, die externen EntityReference-Knoten untergeordnet sind, geben die Position der Entität selbst zurück. Betrachten Sie beispielsweise das folgende XML-Dokument:

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

Dabei enthält die externe Entität a/b.xml den folgenden XML-Text: <test>123</test>.

Wenn das Dokument von https://server/mydata.xml geladen wird, gibt BaseURI Folgendes zurück:

NodeType

Name

BaseURI

Attribute

num

https://server/mydata.xml

Document

#document

https://server/mydata.xml

DocumentType

item

https://server/mydata.xml

Entity

xyz

https://server/mydata.xml

Element

item

https://server/mydata.xml

EntityReference

xyz

https://server/mydata.xml

Element

test

https://server/a/b.xml

Text

#text

https://server/a/b.xml

BaseURI sucht nach Grenzen von Entitätsverweisen. Beim Erweitern von Entitäten werden diese Informationen nicht beibehalten, und diese Eigenschaft gibt die Position des XmlDocument-Objekts in sämtlichen Fällen zurück.

Als zweites Beispiel, wenn das folgende XML-Dokument vorhanden ist:

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

Dabei enthält die DTD-Datei Folgendest:

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

Wenn das XML-Dokument von https://localhost/mydata.xml geladen wird, gibt BaseURI für jeden einzelnen Knoten Folgendes zurück:

NodeType

Name

BaseURI

Document

#document

https://localhost/mydata.xml

DocumentType

Mydata

https://localhost/mydata.xml

Mit der XmlDocumentType.SystemId-Eigenschaft oder der XmlDocumentType.PublicId-Eigenschaft kann die Herkunft der geladenen DTD-Datei bestimmt werden.

Element

baa

https://localhost/mydata.xml

Entity

xyz

https://localhost/doctype.dtd

EntityReference

xyz

https://localhost/mydata.xml

Attribute

woof

https://localhost/mydata.xml

Hinweis

Der Basis-URI eines Standardattributs ist mit dem Basis-URI des zugehörigen Elements identisch.

Diese Eigenschaft ist eine Microsoft-Erweiterung des Dokumentobjektmodells (Document Object Model, DOM).

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

XmlNode-Klasse
XmlNode-Member
System.Xml-Namespace