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οδιαλύων επιτρέπει τη μετάφραση όλων των προθεμάτων, συμπεριλαμβανομένου του thexml πρόθεμα namespace, εντός της έκφρασης XPath σε κατάλληλα URI χώρου ονομάτων. Εάν αυτό έχει καθοριστεί ωςμηδενικό , οποιοδήποτε πρόθεμα χώρου ονομάτων εντός της έκφρασης θα έχει ως αποτέλεσμα 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.

Δείτε επίσης