XPathNavigator.UnderlyingObject Özellik
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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; }
public virtual object UnderlyingObject { get; }
member this.UnderlyingObject : obj
Public Overridable ReadOnly Property UnderlyingObject As Object
Özellik Değeri
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. UnderlyingObject özelliği bu temel alınan nesneleri kullanıma sunar.
Çoğu durumda, bu değer olur null
ve özelliği tarafından UnderlyingObject döndürülen nesne her zaman uygulamaya özgü olur.
UnderlyingObject özelliği nesne kimliğini korumalı ve yalnızca ilgili üst düzey öğ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.
Not
Bir UnderlyingObject nesne tarafından XmlDocument oluşturulan bir XPathNavigator nesnenin özelliği, karşılık gelen XmlNodeöğesini döndürür.