WorksheetBase.XmlDataQuery-Methode
Ruft ein Range-Objekt ab, das die einem bestimmten XPath zugeordneten Zellen darstellt.Ruft nullein Nullverweis (Nothing in Visual Basic) ab, wenn dem Arbeitsblatt nicht der angegebene XPath zugeordnet wurde oder wenn der zugeordnete Bereich leer ist.
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Syntax
'Declaration
Public Function XmlDataQuery ( _
xPath As String, _
selectionNamespaces As Object, _
map As Object _
) As Range
public Range XmlDataQuery(
string xPath,
Object selectionNamespaces,
Object map
)
Parameter
- xPath
Typ: System.String
Der abzufragende XPath.
- selectionNamespaces
Typ: System.Object
Eine durch Leerzeichen getrennte Zeichenfolge mit den Namespaces, auf die im XPath-Parameter verwiesen wird.Wenn einer der angegebenen Namespaces nicht aufgelöst werden kann, wird ein Laufzeitfehler generiert.
- map
Typ: System.Object
Ein XmlMap.Geben Sie eine XML-Zuordnung an, wenn Sie den XPath in einer bestimmten Zuordnung abfragen möchten.
Rückgabewert
Typ: Microsoft.Office.Interop.Excel.Range
Ein Range-Objekt, das die einem bestimmten XPath zugeordneten Zellen darstellt; nullein Nullverweis (Nothing in Visual Basic), wenn der angegebene XPath dem Arbeitsblatt nicht zugeordnet wurde oder der zugeordnete Bereich leer ist.
Hinweise
XML-Features stehen mit Ausnahme des Speicherns von Dateien im XML-Arbeitsblattformat nur in Microsoft Office Professional Edition 2003 und Microsoft Office Excel 2003 zur Verfügung.
Wenn der XPath in einer Spalte einer XML-Liste vorhanden ist, schließt das zurückgegebene Range-Objekt die Überschrift und die Einfügezeile nicht ein.
Optionale Parameter
Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.
Beispiele
Im folgenden Codebeispiel wird die XmlDataQuery-Methode verwendet, um den Range der Zellen abzurufen, der einem bestimmten XPath zugeordnet ist.
Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.
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);
if (range1 == null)
{
MessageBox.Show("The specified XPath: '" + path +
"' has not been mapped to the worksheet, or the mapped " +
"range is empty.");
}
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.