XmlNode.BaseURI Properti

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlNode.cs

Mendapatkan URI dasar simpul saat ini.

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

Nilai Properti

String

Lokasi tempat simpul dimuat atau String.Empty jika simpul tidak memiliki URI dasar.

Keterangan

Dokumen XML berjaringan terdiri dari potongan data yang dikumpulkan menggunakan berbagai mekanisme penyertaan standar W3C dan oleh karena itu berisi simpul yang berasal dari tempat yang berbeda. Memberi BaseURI tahu Anda dari mana simpul ini berasal.

Nilai properti ini bervariasi tergantung pada jenis node. Misalnya, Node dokumen mengembalikan lokasi XmlDocument objek. Simpul yang merupakan simpul anak dari node EntityReference eksternal mengembalikan lokasi entitas itu sendiri. Misalnya, pertimbangkan dokumen XML berikut:

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

di mana entitas a/b.xml eksternal berisi teks XML: <test>123</test>.

Jika dokumen dimuat dari http://server/mydata.xml, BaseURI mengembalikan yang berikut ini:

NodeType	Nama	BaseURI
Attribute	Num	http://server/mydata.xml
Dokumen	#document	http://server/mydata.xml
Jenis Dokumen	item	http://server/mydata.xml
Entitas	Xyz	http://server/mydata.xml
Elemen	item	http://server/mydata.xml
EntityReference	Xyz	http://server/mydata.xml
Elemen	ujian	http://server/a/b.xml
Teks	#text	http://server/a/b.xml

BaseURI mencari batas referensi entitas, jadi jika entitas diperluas, informasi ini tidak dipertahankan dan properti ini mengembalikan lokasi XmlDocument objek dalam semua kasus.

Sebagai contoh kedua, mengingat dokumen XML berikut:

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

Di mana file DTD berisi yang berikut ini:

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

Jika dokumen XML dimuat dari http://localhost/mydata.xml, BaseURI mengembalikan yang berikut ini untuk setiap simpul:

NodeType	Nama	BaseURI
Dokumen	#document	http://localhost/mydata.xml
Jenis Dokumen	Mydata	http://localhost/mydata.xml Properti XmlDocumentType.SystemId atau XmlDocumentType.PublicId dapat digunakan untuk mengidentifikasi dari mana file DTD dimuat.
Elemen	Baa	http://localhost/mydata.xml
Entitas	Xyz	http://localhost/doctype.dtd
EntityReference	Xyz	http://localhost/mydata.xml
Attribute	woof	http://localhost/mydata.xml

Nota

URI dasar atribut default sama dengan URI dasar elemen tempat mereka berada.

Properti ini adalah ekstensi Microsoft ke Model Objek Dokumen (DOM).