SelectNodes

CompositeNode.SelectNodes method

يحدد قائمة العقد المطابقة لتعبير XPath.

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

قيمة الإرجاع

قائمة العقد المطابقة لاستعلام XPath.

ملاحظات

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

أمثلة

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

Document doc = new Document(MyDir + "Mail merge destination - Northwind employees.docx");

// ستحتوي NodeList الناتجة عن تعبير XPath هذا على جميع العقد التي نجدها داخل الحقل.
// ومع ذلك، يمكن أن تكون عقد FieldStart وFieldEnd موجودة في القائمة إذا كانت هناك حقول متداخلة في المسار.
// لا يتم حاليًا العثور على حقول نادرة حيث يمتد FieldCode أو FieldResult عبر فقرات متعددة.
NodeList resultList =
    doc.SelectNodes("//FieldStart/following-sibling::node()[following-sibling::FieldEnd]");

// تحقق مما إذا كان التشغيل المحدد هو أحد العقد الموجودة داخل الحقل.
Console.WriteLine($"Contents of the first Run node that's part of a field: {resultList.First(n => n.NodeType == NodeType.Run).GetText().Trim()}");

يوضح كيفية تحديد عقد معينة باستخدام تعبير 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());

أنظر أيضا

CompositeNode.RemoveSmartTags CompositeNode.SelectSingleNode