IXPathEvaluator.Evaluate

IXPathEvaluator.Evaluate method

Bir XPath ifade dizesini değerlendirir ve mümkünse belirtilen türden bir sonuç döndürür.

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)
ParametreTipTanım
expressionStringAyrıştırılacak ve değerlendirilecek XPath ifade dizesi.
contextNodeNodebubağlam bu XPath ifadesinin değerlendirilmesi için bağlam düğümüdür. EğerIXPathEvaluator yayınlanarak elde edildiDocument o zaman bu aynı belgeye ait olmalı ve bir olmalıdırDocument ,Element ,Attr ,Text , CDATASection ,Comment ,ProcessingInstruction , veyaXPathNamespace düğüm. Bağlam düğümü birText veya bir CDATASectionbu durumda bağlam, XPath bağlamı olarak hizmet vermeyebilecek boş olmadığı sürece, XPath tarafından görüldüğü gibi tüm mantıksal metin düğümü olarak yorumlanır.
resolverIXPathNSResolverbuçözücü dahil olmak üzere tüm öneklerin çevirisine izin verirxml ad alanı öneki, XPath ifadesi içinde uygun ad alanı URI’lerine. Bu, şu şekilde belirtilirsehükümsüz , ifade içindeki herhangi bir ad alanı öneki, ile sonuçlanacaktır.DOMException kod ile atılıyorNAMESPACE_ERR.
typeXPathResultTypeeğer belirlitip belirtilirse sonuç, karşılık gelen tür olarak döndürülür. XPath 1.0 sonuçları için bu, değerlerinden biri olmalıdır.XPathResultType Sıralama.
resultObjectbusonuç yeniden kullanılabilen ve bu yöntemle döndürülebilen belirli bir sonuç nesnesini belirtir. Bu olarak belirtilirsehükümsüzveya uygulama belirtilen sonucu yeniden kullanmaz, yeni bir sonuç nesnesi oluşturulur ve döndürülür. XPath 1.0 sonuçları için bu nesne şu türde olacaktır:IXPathResult.

Geri dönüş değeri

XPath ifadesinin değerlendirmesinin sonucu. XPath 1.0 sonuçları için, bu nesne türünde olacaktırIXPathResult.

istisnalar

istisnaşart
DOMExceptionINVALID_EXPRESSION_ERR: İfade, kurallarına göre geçerli değilse ortaya çıkar.IXPathEvaluator.
DOMExceptionTYPE_ERR: Sonuç, belirtilen tipini döndürmek için dönüştürülemezse yükseltilir.
DOMExceptionNAMESPACE_ERR: İfade, belirtilen tarafından çözümlenemeyen ad alanı önekleri içeriyorsa tetiklenir.IXPathNSResolver.
DOMExceptionWRONG_DOCUMENT_ERR: Düğüm, bunun tarafından desteklenmeyen bir belgeden.IXPathEvaluator.
DOMExceptionNOT_SUPPORTED_ERR: Düğüm, XPath bağlamı düğümü olarak izin verilen bir tür değil veya istek türüne bu düğüm tarafından izin verilmiyorIXPathEvaluator.

Ayrıca bakınız

IXPathEvaluator.CreateNSResolver