WorksheetBase.XmlMapQuery-Methode
Ruft ein Range-Objekt ab, das die einem bestimmten XPath zugeordneten Zellen darstellt.Ruft nullein Nullverweis (Nothing in Visual Basic) ab, wenn der angegebene XPath dem Arbeitsblatt nicht zugeordnet wurde.
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 XmlMapQuery ( _
xPath As String, _
selectionNamespaces As Object, _
map As Object _
) As Range
public Range XmlMapQuery(
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.
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.
Im Gegensatz zur XmlDataQuery-Methode gibt die XmlMapQuery-Methode die gesamte Spalte einer XML-Liste zurück, einschließlich der Überschrift und der Einfügezeile.
Optionale Parameter
Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.
Beispiele
Im folgenden Codebeispiel wird die XmlMapQuery-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 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);
if (range1 == null)
{
MessageBox.Show("The specified XPath: '" + path +
"' has not been mapped to the worksheet.");
}
}
.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.