XMLNode.SelectSingleNode أسلوب

تحصل على Microsoft.Office.Interop.Word.XMLNodeالكائن الذي يمثل عقدة تابعة أول الذي يطابق XPathمعلمة في Microsoft.Office.Tools.Word.XMLNodeعنصر تحكم.

مساحة الاسم:  Microsoft.Office.Tools.Word
التجميع:  Microsoft.Office.Tools.Word (في Microsoft.Office.Tools.Word.dll)

بناء الجملة

'إقرار
Function SelectSingleNode ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNode

XMLNode SelectSingleNode(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

المعلمات

• XPath
  النوع: System.String
  سلسلة XPath صالحة.

• PrefixMapping
  النوع: System.String
  يوفر البادئة في المخطط ضد الذي إلى على إجراء بحث.استخدام PrefixMappingمعلمة إذا كان XPathيستخدم معلمة أسماء إلى البحث عن عناصر.

• FastSearchSkippingTextNodes
  النوع: System.Boolean
  trueإلى تخطي الجميع العقد نص أثناء يتم الآن البحث عن العقدة المحددة.falseلتضمين نص العقد في بحث.وتكون القيمة الافتراضية هي 0.

القيمة المُرجعة

النوع: Microsoft.Office.Interop.Word.XMLNode
عقدة تابعة أول الذي يطابق XPathمعلمة في Microsoft.Office.Tools.Word.XMLNodeعنصر التحكم.

ملاحظات

تعيين FastSearchSkippingTextNodes falsediminishes الأداء بسبب Microsoft المكتب الكلمة بالبحث الجميع العقد الموجودة في مستند للنص المضمن في عقدة.

المعلمات الإختيارية

ل معلومات تشغيل معلمات اختيارية، راجع يفتقد المتغير و "المعلمات الاختيارية" في حلول Office.

أمثلة

ما يلي تعليمات برمجية يستخدم المثال SelectSingleNodeطريقة للحصول على عقدة تابعة يطابق المعطى XPathمعلمة. مثال ثم يقوم بعرض اسم العقدة التي تم العثور عليها. يفترض هذا المثال أن يحتوي مستند الحالي على XMLNodeباسم CustomerNodeمع عنصر مخطط مطابقة الذي يحتوي على واحد أو أكثر فرع العقد المسمى LastName.

Private Sub FindLastNameNode()
    Dim element As String = "/x:Customer/x:LastName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerLastNameNode.NamespaceURI & "'"

    Dim node As Word.XMLNode = _
        Me.CustomerNode.SelectSingleNode(element, prefix, True)
    If node IsNot Nothing Then
        MsgBox(node.BaseName & " element was found.")
    Else
        MsgBox("The requested node was not found.")
    End If
End Sub

private void FindLastNameNode()
{
    string element = "/x:Customer/x:LastName";
    string prefix = "xmlns:x='" + 
        this.CustomerLastNameNode.NamespaceURI + "'";

    Word.XMLNode node = this.CustomerNode.SelectSingleNode(element,
        prefix, true);
    if (node != null)
    {
        MessageBox.Show(node.BaseName + " element was found.");
    }
    else
    {
        MessageBox.Show("The requested node was not found.");
    }
}

أمن NET Framework.

• الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.

راجع أيضًَا

المرجع

XMLNode واجهة

XMLNode الأعضاء

Microsoft.Office.Tools.Word مساحة الاسم