مشاركة عبر

DocumentBase.SelectSingleNode أسلوب

  • مقالة

بإرجاع Microsoft.Office.Interop.Word.XMLNodeالكائن الذي يمثل أول عقده في مستند الذي يتطابق مع XPathمعلمة.

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

بناء الجملة

'إقرار
Public Function SelectSingleNode ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNode

public XMLNode SelectSingleNode(
    string xPath,
    string prefixMapping,
    bool fastSearchSkippingTextNodes
)

المعلمات

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

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

النوع: Microsoft.Office.Interop.Word.XMLNode
Microsoft.Office.Interop.Word.XMLNodeالكائن الذي يمثل العقدة الأولى التي تطابق XPathمعلمة في مستند؛ nullمرجع خالٍ (لا شيء في Visual Basic)إذا كان العقد لا تطابق XPathالعثور على المعلمة.

ملاحظات

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

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

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

أمثلة

ما يلي تعليمات برمجية مثال يوضح كيفية تعيين XPathو PrefixMappingالمعلمات عند استدعاء SelectSingleNodeالأسلوب. إلى لاستخدام هذا المثال، قم بتشغيلها من ThisDocumentالفئة في مشروع المستوى مستند.

Private Sub DocumentSelectSingleNode()
    If Me.XMLSchemaReferences.Count > 0 Then
        Dim XPath As String = "/x:catalog/x:book/x:title"
        Dim PrefixMapping As String = "xmlns:x=""" + _
            Me.XMLSchemaReferences(1).NamespaceURI + """"
        Dim node As Word.XMLNode = Me.SelectSingleNode(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

private void DocumentSelectSingleNode()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;

        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences.get_Item(ref key).NamespaceURI +
            "\"";

        Word.XMLNode node = this.SelectSingleNode(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

أمن NET Framework.

راجع أيضًَا

المرجع

DocumentBase الفئة

DocumentBase الأعضاء

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