WorksheetBase.XmlMapQuery(String, Object, Object) Methode

Definition

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

Range

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.

Gilt für