SelectSingleNode

CompositeNode.SelectSingleNode method

يحدد الأولNode الذي يتطابق مع تعبير XPath.

public Node SelectSingleNode(string xpath)
معامليكتبوصف
xpathStringتعبير XPath.

قيمة الإرجاع

الأولNode الذي يتطابق مع استعلام XPath أوباطل إذا لم يتم العثور على عقدة مطابقة.

ملاحظات

حاليًا، لا يُدعم سوى التعبيرات التي تحتوي على أسماء عناصر. التعبيرات التي تستخدم أسماء السمات غير مدعومة.

أمثلة

يوضح كيفية تحديد عقد معينة باستخدام تعبير XPath.

Document doc = new Document(MyDir + "Tables.docx");

// هذا التعبير سوف يستخرج جميع عقد الفقرات،
// والتي هي من نسل أي عقدة جدول في المستند.
NodeList nodeList = doc.SelectNodes("//الجدول//فقرة");

// قم بالتكرار خلال القائمة باستخدام مُعَدِّد وقم بطباعة محتويات كل فقرة في كل خلية من الجدول.
int index = 0;

using (IEnumerator<Node> e = nodeList.GetEnumerator())
    while (e.MoveNext())
        Console.WriteLine($"Table paragraph index {index++}, contents: \"{e.Current.GetText().Trim()}\"");

// سيقوم هذا التعبير بتحديد أي فقرات تعتبر أبناءً مباشرين لأي عقدة نص في المستند.
nodeList = doc.SelectNodes("//النص/الفقرة");

//يمكننا التعامل مع القائمة كمصفوفة.
Assert.AreEqual(4, nodeList.ToArray().Length);

// استخدم SelectSingleNode لتحديد النتيجة الأولى لنفس التعبير المذكور أعلاه.
Node node = doc.SelectSingleNode("//النص/الفقرة");

Assert.AreEqual(typeof(Paragraph), node.GetType());

أنظر أيضا