IXPathExpression.Evaluate

IXPathExpression.Evaluate method

بتقييم تعبير XPath هذا وإرجاع نتيجة.

public IXPathResult Evaluate(Node contextNode, XPathResultType type, object result)
معامليكتبوصف
contextNodeNodeالسياق هي عقدة سياق لتقييم تعبير XPath هذا. إذا كان ملفIXPathEvaluator تم الحصول عليها عن طريق صبDocument إذًا يجب أن يكون هذا مملوكًا لنفس المستند ويجب أن يكون ملفDocument وElement وAttr ، Text وCDATASection وComment وProcessingInstruction أو أوXPathNamespace العقدة. إذا كانت عقدة السياق هي ملفText أو أCDATASection، ثم يتم تفسير السياق على أنه عقدة النص المنطقي بالكامل كما يراها XPath ، إلا إذا كانت العقدة فارغة وفي هذه الحالة قد لا تعمل كسياق XPath.
typeXPathResultTypeإذا كان ملفيكتب تم تحديده ، ثم سيتم إجبار النتيجة على إرجاع النوع المحدد الذي يعتمد على تحويلات XPath والفشل إذا كان الإكراه المطلوب غير ممكن. يجب أن تكون إحدى قيمXPathResultType.
resultObjectالنتيجة يحدد كائن نتيجة محدد يمكن إعادة استخدامه وإعادته بهذه الطريقة. إذا تم تحديد هذا على أنهباطلأو أن التطبيق لا يعيد استخدام نتيجة المحددة ، فسيتم إنشاء كائن نتيجة جديد وإرجاعه. بالنسبة لنتائج XPath 1.0 ، سيكون هذا الكائن من النوعIXPathResult.

قيمة الإرجاع

نتيجة تقييم تعبير XPath. بالنسبة لنتائج XPath 1.0 ، سيكون هذا الكائن من النوعIXPathResult.

استثناءات

استثناءحالة
DOMExceptionTYPE_ERR: يتم رفعه إذا تعذر تحويل النتيجة لإرجاع النوع المحدد.
DOMExceptionWRONG_DOCUMENT_ERR: العقدة من مستند لا يدعمه IXPathEvaluator التي خلقت هذاIXPathExpression.
DOMExceptionNOT_SUPPORTED_ERR: العقدة ليست نوعًا مسموحًا به كعقدة سياق XPath أو نوع الطلب غير مسموح به بواسطة هذاIXPathExpression.

أنظر أيضا