IXPathEvaluator.Evaluate

IXPathEvaluator.Evaluate method

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

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

قيمة الإرجاع

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

استثناءات

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

أنظر أيضا