WorksheetBase.XmlMapQuery(String, Object, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ein Range-Objekt ab, das die einem bestimmten XPath zugeordneten Zellen darstellt. Ruft null ab, wenn der angegebene XPath dem Arbeitsblatt nicht zugeordnet wurde.
public Microsoft.Office.Interop.Excel.Range XmlMapQuery (string xPath, object selectionNamespaces, object map);
Parameter
- xPath
- String
Der abzufragende XPath.
- selectionNamespaces
- 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
- Object
Eine XmlMap. Geben Sie eine XML-Zuordnung an, wenn Sie den XPath in einer bestimmten Zuordnung abfragen möchten.
Gibt zurück
Ein Range-Objekt, das die einem bestimmten XPath zugeordneten Zellen darstellt; null, wenn der angegebene XPath dem Arbeitsblatt nicht zugeordnet wurde.
Beispiele
Im folgenden Codebeispiel wird die- XmlMapQuery Methode verwendet, um die Range von Zellen, die einem bestimmten XPath zugeordnet sind, zu erhalten.
Dieses Beispiel gilt für eine Anpassung auf Dokument Ebene.
private void WorksheetQueryXmlMap()
{
string path = "/order/customer/address";
string namespaces = "xmlns=http://www.contoso.com/orders";
Excel.Range range1 = this.XmlMapQuery(path, namespaces);
if (range1 == null)
{
MessageBox.Show("The specified XPath: '" + path +
"' has not been mapped to the worksheet.");
}
}
Private Sub WorksheetQueryXmlMap()
Dim path As String = "/order/customer/address"
Dim namespaces As String = "xmlns=http://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
Hinweise
XML-Funktionen, außer zum Speichern von Dateien im XML-Tabellenformat, sind nur in Microsoft Office Professional Edition 2003 und Microsoft Office Excel 2003 verfügbar.
Anders als bei der- XmlDataQuery Methode gibt die- XmlMapQuery Methode die gesamte Spalte einer XML-Liste zurück, einschließlich der Kopfzeile und der Einfügezeile.
Optionale Parameter
Weitere Informationen zu optionalen Parametern finden Sie unter optionale Parameter in Office-Projektmappen.