XPathNavigator.UnderlyingObject Özellik

Tanım

XPathNavigatorBir mağaza üzerinde "sanallaştırılan" xml görünümü sağlayan uygulamalar tarafından, temel alınan nesnelere erişim sağlamak için kullanılır.Used by XPathNavigator implementations which provide a "virtualized" XML view over a store, to provide access to underlying objects.

public:
 virtual property System::Object ^ UnderlyingObject { System::Object ^ get(); };
public virtual object? UnderlyingObject { 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.The default is null.

Açıklamalar

UnderlyingObjectÖzelliği, XPathNavigator temel nesnelere erişim sağlamak için bir mağaza üzerinde "sanallaştırılmış" bir xml görünümü sağlayan uygulamalar tarafından kullanılabilir.The UnderlyingObject property can be used by XPathNavigator implementations which provide a "virtualized" XML view over a store, to provide access to underlying objects. Örneğin, bir XPathNavigator nesne ortak dil çalışma zamanı (CLR) nesne grafı üzerinde sanal xml görünümü sağlamak için kullanılıyorsa, yöntemi kullanarak XPath sorguları gerçekleştirmek Select ve ardından seçilen düğümleri temel alan CLR nesnelerine erişmek isteyebilirsiniz.For example, if an XPathNavigator object is used to provide a virtual XML view over a Common Language Runtime (CLR) object graph, you may wish to perform XPath queries using the Select method and then access the CLR objects underlying the selected nodes. UnderlyingObjectÖzelliği bu temel nesneleri kullanıma sunar.The UnderlyingObject property would expose these underlying objects.

Çoğu durumda bu değer olacaktır null ve özelliği tarafından döndürülen nesne UnderlyingObject her zaman uygulamaya özgü olur.In many cases, this value will be null, and the object returned by the UnderlyingObject property will always be implementation specific.

UnderlyingObjectÖzelliği, nesne kimliğini korumalı ve yalnızca ilgili kaplama öğelerine bire bir yazışmalı nesneleri döndürmek için kullanılmalıdır.The UnderlyingObject property should preserve object identity and should only be used to return objects that have a one-to-one correspondence to their respective overlaid items. Bir kullanıcı aynı nesneyi her zaman aynı XPathNavigator veya klonlanan bir nesne kullanarak art arda yapılan ziyaretlerde almalıdır.A user should always get the same object on successive visits to the same node using the same XPathNavigator object or a cloned one.

Not

UnderlyingObject XPathNavigator Bir nesne tarafından oluşturulan nesnenin özelliği XmlDocument karşılık gelen ' i döndürür XmlNode .The UnderlyingObject property of an XPathNavigator object created by an XmlDocument object returns the corresponding XmlNode.

Şunlara uygulanır