WorksheetBase.XmlMapQuery – metoda

Článek
01/03/2014

Získá objekt Range, který představuje buňky mapované na určitou cestu XPath.Získává nullodkaz null (Nothing v jazyce Visual Basic) -li zadaný výraz XPath není namapováno na listu.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel.v4.0.Utilities (v Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntaxe

'Deklarace
Public Function XmlMapQuery ( _
    xPath As String, _
    selectionNamespaces As Object, _
    map As Object _
) As Range

public Range XmlMapQuery(
    string xPath,
    Object selectionNamespaces,
    Object map
)

Parametry

xPath
Typ: System.String
Cesta XPath pro odeslání dotazu

selectionNamespaces
Typ: System.Object
Mezerami oddělený řetězec, který obsahuje obor názvů odkazovaný v parametru XPath.Pokud jeden z určených oborů názvů nelze vyřešit, vygeneruje se chyba za běhu.

map
Typ: System.Object
Objekt XmlMap.Určete mapu XML, pokud chcete v určené mapě zadat dotaz na cestu XPath.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Excel.Range
A Range objekt, který představuje buněk mapován na určitý XPath; nullodkaz null (Nothing v jazyce Visual Basic)Pokud zadaná cesta XPath byl namapován na list.

Poznámky

Funkce XML, s výjimkou ukládání souborů ve formátu tabulky XML, jsou k dispozici pouze v aplikaci Microsoft Office Professional Edition 2003 a Microsoft Office Excel 2003.

Na rozdíl od XmlDataQuery metoda, XmlMapQuery metoda vrátí celý sloupec seznamu XML, včetně záhlaví a řádek vložit.

Volitelné parametry

Informace o volitelných parametrech naleznete v tématu Volitelné parametry v řešeních pro systém Office.

Příklady

Následující příklad kódu používá XmlMapQuery metoda získat Range buněk mapován na určitý XPath.

Tento příklad je pro přizpůsobení na úrovni dokumentu.

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.");
    }
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

WorksheetBase Třída

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím