XML DOM روش evaluate()
تعریف و استفاده
مетод evaluate() یک بیان XPath را محاسبه می‌کند.
نحوه‌ی نوشتن:
evaluate(xpathText,contextNode,namespaceURLMapper,resultType,result)
| پارامتر | وصف |
|---|---|
| xpathText | نمایانگر یک رشته بیان XPath که می‌خواهد محاسبه شود. |
| contextNode | در مستند، گره‌هایی که به معنای بیان مورد محاسبه قرار دارند. |
| namespaceURLMapper |
یک تابع برای نقشه‌گذاری یک پیشوند نام‌گذاری شده به یک URL نام‌گذاری شده کامل است. اگر نیازی به این نقشه‌گذاری نیست، آن را null قرار دهید. |
| resultType |
نوع شیء مورد انتظار به عنوان نتایج، با استفاده از تبدیل XPath به طور اجباری نوع نتایج را مشخص می‌کند. ممکنه‌ی نوعهای ممکنه‌ی result نوعهای ممکنه‌ی XPathResult کی اشیاء تعریف شده‌اند. |
| result |
یک شیء XPathResult قابل استفاده مجدد؛ اگر می‌خواهید یک شیء XPathResult جدید ایجاد کنید، آن را null قرار دهید。 |
بازگشتی
نمایانگر یک XPathResult کی اشیاء。
پرتاب کری
اگر xpathText با خطای گرامری شامل است، یا اگر نتایج عبارت نمی‌توانند به نوع مورد انتظار تبدیل شوند. resultType، یا اگر عبارت شامل namespaceURLMapper فضای نام قابل درک نیست، یا اگر contextNode با نوع اشتباه یا اگر با این مستند مربوط نیست، این روش یک استثنا می‌اندازد.
وصف
این روش بر اساس گزینه‌های داده شده از Node برای محاسبه عبارت XPath مشخص شده و یک XPathResult به عنوان نوع بازگشتی را محاسبه می‌کند که نوع بازگشتی باید چه چیزی باشد. اگر بخواهید یک عبارت را چندین بار محاسبه کنید، از Document.createExpression() برای اینکه عبارت را به یک XPathExpression علامت، سپس از روش evaluate() XPathExpression استفاده کنید.
این API توسط IE پشتیبانی نمی‌شود. دریافت کنید Node.selectNodes() و Node.selectSingleNode() یک روش جایگزین مخصوص IE را بشناسید.
