WorksheetBase.XmlDataQuery أسلوب
يحصل 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 XmlDataQuery ( _
xPath As String, _
selectionNamespaces As Object, _
map As Object _
) As Range
public Range XmlDataQuery(
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.
في حالة وجود XPath ضمن عمود في قائمة XML، Rangeإرجاع كائن لا يحتوي صف عنوان أو صف إدراج.
المعلمات الإختيارية
ل معلومات تشغيل معلمات اختيارية، راجع يفتقد المتغير و "المعلمات الاختيارية" في حلول Office.
أمثلة
ما يلي تعليمات برمجية يستخدم المثال XmlDataQueryطريقة للحصول على Rangeخلايا المعينة إلى XPath معينة.
Th هو المثال هو لتخصيص المستوى مستند.
Private Sub WorksheetQueryXmlData()
Dim path As String = "/order/customer/address"
Dim namespaces As String = "xmlns=https://www.contoso.com/orders"
Dim range1 As Excel.Range = _
Me.XmlDataQuery(path, namespaces)
If range1 Is Nothing Then
MsgBox("The specified XPath: '" & path & _
"' has not been mapped to the worksheet, or the mapped " & _
"range is empty.")
End If
End Sub
private void WorksheetQueryXmlData()
{
string path = "/order/customer/address";
string namespaces = "xmlns=https://www.contoso.com/orders";
Excel.Range range1 = this.XmlDataQuery(path, namespaces, missing);
if (range1 == null)
{
MessageBox.Show("The specified XPath: '" + path +
"' has not been mapped to the worksheet, or the mapped " +
"range is empty.");
}
}
أمن NET Framework.
- الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.