Evaluate

IXPathEvaluator.Evaluate method

Valuta una stringa di espressione XPath e, se possibile, restituisce un risultato del tipo specificato.

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)
ParametroTipoDescrizione
expressionStringLa stringa dell’espressione XPath da analizzare e valutare.
contextNodeNodeIlcontesto è il nodo di contesto per la valutazione di questa espressione XPath. Se laIXPathEvaluator è stato ottenuto colando il Document quindi questo deve essere di proprietà dello stesso documento e deve essere un Document ,Element ,Attr ,Text , CDATASection ,Comment ,ProcessingInstruction , oXPathNamespace nodo. Se il nodo di contesto è aText o un CDATASectionil contesto viene interpretato come l’intero nodo di testo logico visto da XPath, a meno che il nodo non sia vuoto, nel qual caso potrebbe non fungere da contesto XPath.
resolverIXPathNSResolverIlrisolutore consente la traduzione di tutti i prefissi, incluso thexml prefisso dello spazio dei nomi, all’interno dell’espressione XPath negli URI dello spazio dei nomi appropriati. Se questo è specificato comenullo , qualsiasi prefisso dello spazio dei nomi all’interno dell’espressione risulterà inDOMException essere lanciato con il codiceNAMESPACE_ERR.
typeXPathResultTypeSe uno specificogenere è specificato, il risultato verrà restituito come del tipo corrispondente. Per i risultati di XPath 1.0, questo deve essere uno dei valori di XPathResultType enum.
resultObjectIlrisultato specifica un oggetto risultato specifico che può essere riutilizzato e restituito da questo metodo. Se questo è specificato comenullo l’implementazione non riutilizza il risultato specificato, verrà costruito e restituito un nuovo oggetto risultato. Per i risultati di XPath 1.0 , questo oggetto sarà di tipoIXPathResult.

Valore di ritorno

Il risultato della valutazione dell’espressione XPath. Per i risultati di XPath 1.0, questo oggetto sarà di tipoIXPathResult.

Eccezioni

eccezionecondizione
DOMExceptionINVALID_EXPRESSION_ERR: sollevato se l’espressione non è legale secondo alle regole delIXPathEvaluator.
DOMExceptionTYPE_ERR: generato se il risultato non può essere convertito per restituire il tipo specificato .
DOMExceptionNAMESPACE_ERR: generato se l’espressione contiene prefissi dello spazio dei nomi che non possono essere risolti dalIXPathNSResolver.
DOMExceptionWRONG_DOCUMENT_ERR: il nodo proviene da un documento che non è supportato da questoIXPathEvaluator.
DOMExceptionNOT_SUPPORTED_ERR: il nodo non è un tipo consentito come nodo XPath o il tipo di richiesta non è consentito da questoIXPathEvaluator.

Guarda anche

CreateNSResolver