WorksheetBase.XmlMapQuery – metoda

Článek
08/11/2011

Získává Range objekt představující buňky mapovány na určité XPath. Získá nullodkaz Null (Nothing v jazyce Visual Basic) -li zadaný výraz XPath byl namapován na list.

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
Výraz XPath pro dotaz .

selectionNamespaces
Typ: System.Object
Oddělené řetězec, který obsahuje parametrcesta XPath odkazuje obory názvů.Spuštění chyba je generována pokud jedno zadané obory názvů nelze přeložit.

map
Typ: System.Object
An XmlMap.Pokud chcete dotaz XPath v rámci konkrétní mapaurčetemapa jazyk XML.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Excel.Range
A Range objekt představující buňky mapovány na určité XPath; nullodkaz Null (Nothing v jazyce Visual Basic)Pokud zadaná cesta XPath byl namapován na list.

Poznámky

jazyk XML nabízí kromě pro ukládání souborů ve formátu Tabulka jazyk XML jsou k dispozici pouze v systém Microsoft Office Professional Edition 2003 a systém Microsoft Office Excel 2003.

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

Volitelné parametry

Informace o volitelných parametrů, viz The Variable missing and Optional Parameters in Office Solutions.

Příklady

Následující kód například použití XmlMapQuery metodu Range buněk mapován na určitý XPath.

Tento příklad je přizpůsobení ú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, missing);

    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é

Odkaz

WorksheetBase Třída

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

Sdílet prostřednictvím