IXPathEvaluator.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 lanciando Document allora 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 specificotipo è specificato, il risultato verrà restituito come il tipo corrispondente. Per i risultati 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 XPath 1.0 , questo oggetto sarà di tipoIXPathResult.

Valore di ritorno

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

Eccezioni

eccezionecondizione
DOMExceptionINVALID_EXPRESSION_ERR: sollevata se l’espressione non è legale secondo secondo le regole delIXPathEvaluator.
DOMExceptionTYPE_ERR: sollevato se il risultato non può essere convertito per restituire il tipo specificato.
DOMExceptionNAMESPACE_ERR: sollevato se l’espressione contiene prefissi dello spazio dei nomi che non possono essere risolti dall’oggetto specificatoIXPathNSResolver.
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 del contesto XPath o il tipo di richiesta non è consentito da questoIXPathEvaluator.

Guarda anche