WorksheetBase.XmlDataQuery – 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) Pokud zadaná cesta XPath není namapováno na listnebo mapované oblasti je prázdná.

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 XmlDataQuery ( _
    xPath As String, _
    selectionNamespaces As Object, _
    map As Object _
) As Range

public Range XmlDataQuery(
    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 není namapováno na listnebo mapované oblasti je prázdný.

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.

Pokud existuje v rámci sloupec v seznamu jazyk XML , XPath Rangevrátilobjekt neobsahuje hlavička nebo řádku 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í XmlDataQuery metodu Range buněk mapován na určitý XPath.

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

Private Sub WorksheetQueryXmlData()
    Dim path As String = "/order/customer/address"
    Dim namespaces As String = "xmlns=https://www.contoso.com/orders"

    Dim range1 As Excel.Range = _
        Me.XmlDataQuery(path, namespaces)

    If range1 Is Nothing Then
        MsgBox("The specified XPath: '" & path & _
            "' has not been mapped to the worksheet, or the mapped " & _
                "range is empty.")
    End If
End Sub

private void WorksheetQueryXmlData()
{
    string path = "/order/customer/address";
    string namespaces = "xmlns=https://www.contoso.com/orders";

    Excel.Range range1 = this.XmlDataQuery(path, namespaces, missing);

    if (range1 == null)
    {
        MessageBox.Show("The specified XPath: '" + path + 
            "' has not been mapped to the worksheet, or the mapped " +
            "range is empty.");
    }
}

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