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. |
أنظر أيضا
- interface IXPathResult
- class Node
- interface IXPathNSResolver
- enum XPathResultType
- interface IXPathEvaluator
- مساحة الاسم Aspose.Svg.Dom.XPath
- المجسم Aspose.SVG
