Evaluate

IXPathEvaluator.Evaluate method

بتقييم سلسلة تعبير XPath وإرجاع نتيجة من النوع المحدد إن أمكن.

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)
معامل يكتب وصف
expression String سلسلة تعبير XPath المراد تحليلها وتقييمها.
contextNode Node السياق الكلام هي عقدة سياق لتقييم تعبير XPath هذا. إذا كانIXPathEvaluator تم الحصول عليها عن طريق صب Document ثم يجب أن يكون هذا مملوكًا لنفس المستند ويجب أن يكون Document وElement وAttr وText ، CDATASection وComment وProcessingInstruction أو أوXPathNamespace العقدة. إذا كانت عقدة السياق هي ملفText أو CDATASection، ثم يتم تفسير السياق على أنه عقدة النص المنطقي بأكملها كما يراها XPath ، إلا إذا كانت العقدة فارغة وفي هذه الحالة قد لا تعمل كسياق XPath.
resolver IXPathNSResolver المحلل يسمح بترجمة جميع البادئات ، بما في ذلك xml بادئة مساحة الاسم ، ضمن تعبير XPath إلى مساحة الاسم المناسبة URIs. إذا تم تحديد ذلك كـلا شيء ، ستؤدي أي بادئة لمساحة الاسم داخل التعبير إلى فيDOMException تم إلقاؤهم مع الرمزNAMESPACE_ERR.
type XPathResultType إذا كان ملفيكتب تم تحديده ، ثم سيتم إرجاع النتيجة كـ من النوع المقابل. بالنسبة لنتائج XPath 1.0 ، يجب أن تكون هذه إحدى قيم XPathResultType تعداد.
result Object النتيجة يحدد كائن نتيجة محدد يمكن إعادة استخدامه وإعادته بهذه الطريقة. إذا تم تحديد هذا على أنهلا شيءأو أن التنفيذ لا يعيد استخدام النتيجة المحددة ، فسيتم إنشاء كائن نتيجة جديد وإرجاعه. بالنسبة لنتائج XPath 1.0 ، سيكون هذا الكائن من النوعIXPathResult.

قيمة الإرجاع

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

استثناءات

استثناء حالة
DOMException INVALID_EXPRESSION_ERR: يُرفع إذا كان التعبير غير قانوني وفقًا لقواعدIXPathEvaluator.
DOMException TYPE_ERR: يتم رفعه إذا تعذر تحويل النتيجة لإرجاع النوع المحدد .
DOMException NAMESPACE_ERR: يتم رفعه إذا كان التعبير يحتوي على بادئات مساحة الاسم والتي لا يمكن حلها بواسطة المحددIXPathNSResolver.
DOMException WRONG_DOCUMENT_ERR: العقدة من مستند لا يدعمه هذا IXPathEvaluator.
DOMException NOT_SUPPORTED_ERR: العقدة ليست نوعًا مسموحًا به كعقدة سياق XPath أو نوع الطلب غير مسموح به بواسطة هذاIXPathEvaluator.

أنظر أيضا