XPathNavigator.UnderlyingObject Özellik

Tanım

Ad Alanı:

System.Xml.XPath

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XPathNavigator.cs

Temel alınan nesnelere erişim sağlamak için bir depo üzerinde "sanallaştırılmış" XML görünümü sağlayan uygulamalar tarafından XPathNavigator kullanılır.

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

Özellik Değeri

Object

Varsayılan değer: null.

Açıklamalar

özelliği, UnderlyingObject temel alınan nesnelere erişim sağlamak için bir depo üzerinde "sanallaştırılmış" XML görünümü sağlayan uygulamalar tarafından XPathNavigator kullanılabilir. Örneğin, bir XPathNavigator nesne Ortak Dil Çalışma Zamanı (CLR) nesne grafı üzerinden sanal XML görünümü sağlamak için kullanılıyorsa, yöntemini kullanarak Select XPath sorguları gerçekleştirmek ve ardından seçili düğümlerin temelindeki CLR nesnelerine erişmek isteyebilirsiniz. özelliği bu UnderlyingObject temel nesneleri kullanıma sunar.

Çoğu durumda, bu değer olur nullve özelliği tarafından UnderlyingObject döndürülen nesne her zaman uygulamaya özgü olur.

UnderlyingObject özelliği nesne kimliğini korumalıdır ve yalnızca ilgili yer paylaşımlı öğelerine bire bir karşılık gelen nesneleri döndürmek için kullanılmalıdır. Bir kullanıcı her zaman aynı nesneyi veya kopyalanmış bir nesneyi kullanarak aynı düğüme art arda yapılan ziyaretlerde aynı XPathNavigator nesneyi almalıdır.

Uyarı

Bir UnderlyingObject nesne tarafından oluşturulan bir XPathNavigatorXmlDocument nesnenin özelliği karşılık gelen XmlNodedöndürür.