XPathNavigator.UnderlyingObject Properti

Definisi

Ruang nama:

System.Xml.XPath

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XPathNavigator.cs

Digunakan oleh XPathNavigator implementasi yang menyediakan tampilan XML "virtualisasi" di atas penyimpanan, untuk menyediakan akses ke objek yang mendasar.

public:
 virtual property System::Object ^ UnderlyingObject { System::Object ^ get(); };

public virtual object? UnderlyingObject { get; }

member this.UnderlyingObject : obj

Public Overridable ReadOnly Property UnderlyingObject As Object

Nilai Properti

Object

Defaultnya adalah null.

Keterangan

Properti UnderlyingObject dapat digunakan oleh XPathNavigator implementasi yang menyediakan tampilan XML "virtualisasi" melalui penyimpanan, untuk menyediakan akses ke objek yang mendasar. Misalnya, jika XPathNavigator objek digunakan untuk memberikan tampilan XML virtual melalui grafik objek Common Language Runtime (CLR), Anda mungkin ingin melakukan kueri XPath menggunakan Select metode lalu mengakses objek CLR yang mendasari simpul yang dipilih. Properti UnderlyingObject akan mengekspos objek yang mendasar ini.

Dalam banyak kasus, nilai ini akan menjadi null, dan objek yang dikembalikan oleh UnderlyingObject properti akan selalu spesifik implementasi.

Properti UnderlyingObject harus mempertahankan identitas objek dan hanya boleh digunakan untuk mengembalikan objek yang memiliki korespondensi satu-ke-satu ke item yang dilapisi masing-masing. Pengguna harus selalu mendapatkan objek yang sama pada kunjungan berturut-turut ke simpul yang sama menggunakan objek yang sama XPathNavigator atau yang dikloning.

Nota

Properti UnderlyingObject objek yang XPathNavigator dibuat oleh XmlDocument objek mengembalikan yang sesuai XmlNode.