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.

Δείτε επίσης