SelectNodes

CompositeNode.SelectNodes method

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

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

قيمة الإرجاع

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

ملاحظات

يتم دعم التعبيرات التي تحتوي على أسماء العناصر فقط في الوقت الحالي. Expressions التي تستخدم أسماء السمات غير مدعومة.

أمثلة

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