WorksheetBase.XmlDataQuery – 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 nebo 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
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 nebyla namapována na listu nebo mapované oblasti je prázdná.

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.

Pokud existuje cesta XPath v rámci jednoho sloupce v seznamu XML, Range objekt vrácený neobsahuje řádek záhlaví nebo řádku 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á XmlDataQuery 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 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);

    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é

Referenční dokumentace

WorksheetBase Třída

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

Sdílet prostřednictvím