IXPathEvaluator.Evaluate

IXPathEvaluator.Evaluate method

Mengevaluasi string ekspresi XPath dan mengembalikan hasil dari tipe yang ditentukan jika memungkinkan.

public IXPathResult Evaluate(string expression, Node contextNode, IXPathNSResolver resolver, 
    XPathResultType type, object result)
ParameterJenisKeterangan
expressionStringString ekspresi XPath yang akan diuraikan dan dievaluasi.
contextNodeNodeItukonteks adalah simpul konteks untuk evaluasi ekspresi XPath ini. JikaIXPathEvaluator diperoleh dengan melemparkan Document maka ini harus dimiliki oleh dokumen yang sama dan harus berupa Document ,Element ,Attr ,Text , CDATASection ,Comment ,ProcessingInstruction , atauXPathNamespace simpul. Jika simpul konteks adalah aText atau CDATASectionmaka konteksnya diinterpretasikan sebagai seluruh simpul teks logis seperti yang terlihat oleh XPath, kecuali jika simpul tersebut kosong dalam hal ini mungkin tidak berfungsi sebagai konteks XPath.
resolverIXPathNSResolverItupenyelesai mengizinkan terjemahan semua awalan, termasuk xml awalan namespace, dalam ekspresi XPath ke dalam URI namespace yang sesuai. Jika ini ditentukan sebagaibatal , setiap awalan namespace dalam ekspresi akan menghasilkan DOMException dilemparkan dengan kodeNAMESPACE_ERR.
typeXPathResultTypeJika spesifikjenis ditentukan, maka hasilnya akan dikembalikan sebagai jenis yang sesuai. Untuk hasil XPath 1.0, ini harus menjadi salah satu nilai dari XPathResultType enum.
resultObjectItuhasil menentukan objek hasil tertentu yang dapat digunakan kembali dan dikembalikan oleh metode ini. Jika ini ditentukan sebagaibatalatau implementasi tidak menggunakan kembali hasil yang ditentukan, objek hasil baru akan dibuat dan dikembalikan. Untuk hasil XPath 1.0 , objek ini akan bertipeIXPathResult.

Nilai Pengembalian

Hasil evaluasi ekspresi XPath. Untuk hasil XPath 1.0, objek ini akan bertipeIXPathResult.

Pengecualian

pengecualiankondisi
DOMExceptionINVALID_EXPRESSION_ERR: Dimunculkan jika ekspresi tidak legal menurut aturan dariIXPathEvaluator.
DOMExceptionTYPE_ERR: Dibesarkan jika hasilnya tidak dapat dikonversi untuk mengembalikan tipe yang ditentukan.
DOMExceptionNAMESPACE_ERR: Dibesarkan jika ekspresi berisi prefiks namespace yang tidak dapat diselesaikan oleh yang ditentukanIXPathNSResolver.
DOMExceptionWRONG_DOCUMENT_ERR: Node berasal dari dokumen yang tidak didukung oleh iniIXPathEvaluator.
DOMExceptionNOT_SUPPORTED_ERR: Node bukan tipe yang diizinkan sebagai node konteks XPath atau tipe permintaan tidak diizinkan oleh iniIXPathEvaluator.

Lihat juga

IXPathEvaluator.CreateNSResolver