WorksheetBase.XmlMapQuery أسلوب

مقالة
09/21/2010

يحصل Rangeكائن الذي يمثل خلايا المعينة إلى XPath خاص. تحصل على nullمرجع خالٍ (لا شيء في Visual Basic)إذا لم يتم تعيين XPath المحدد إلى ورقة عمل.

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

بناء الجملة

'إقرار
Public Function XmlMapQuery ( _
    xPath As String, _
    selectionNamespaces As Object, _
    map As Object _
) As Range

public Range XmlMapQuery(
    string xPath,
    Object selectionNamespaces,
    Object map
)

المعلمات

xPath
النوع: System.String
إلى استعلام XPath.

selectionNamespaces
النوع: System.Object
مفصول سلسلة تحتوي على مساحات الاسم المشار إليها في معلمة XPath.خطأ وقت التشغيل هو التي تم إنشاؤها في حالة تعذر حل واحد من مساحات الاسم المحددة.

map
النوع: System.Object
AnXmlMap.قم بتحديد مخطط XML إذا أردت إلى استعلام XPath ضمن مخطط محدد.

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

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

ملاحظات

تتوفر ميزات XML، فيما عدا حفظ الملفات بتنسيق جدول بيانات XML، فقط في Microsoft المكتب 2010 Suite احترافي Edition 2003 و Microsoft المكتب 2010 Suite Excel 2003.

بخلاف XmlDataQueryالأسلوب، XmlMapQueryالأسلوب بإرجاع العمود بأكمله من قائمة XML، بما في ذلك صف الرأس و إدراج صف.

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

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

أمثلة

ما يلي تعليمات برمجية يستخدم المثال XmlMapQueryطريقة للحصول على Rangeخلايا المعينة إلى XPath معينة.

Th هو المثال هو لتخصيص المستوى مستند.

Private Sub WorksheetQueryXmlMap()
    Dim path As String = "/order/customer/address"
    Dim namespaces As String = "xmlns=https://www.contoso.com/orders"

    Dim range1 As Excel.Range = _
        Me.XmlMapQuery(path, namespaces)

    If range1 Is Nothing Then
        MsgBox("The specified XPath: '" & path & _
            "' has not been mapped to the worksheet.")
    End If
End Sub

private void WorksheetQueryXmlMap()
{
    string path = "/order/customer/address";
    string namespaces = "xmlns=https://www.contoso.com/orders";

    Excel.Range range1 = this.XmlMapQuery(path, namespaces, missing);

    if (range1 == null)
    {
        MessageBox.Show("The specified XPath: '" + path +
            "' has not been mapped to the worksheet.");
    }
}

أمن NET Framework.

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