WorksheetBase.XmlDataQuery – metoda

Článek
05/14/2013

Získá Range objekt, který představuje buňky, které jsou mapovány na konkrétního jazyka XPath.Získá nullodkaz null (Nothing v jazyce Visual Basic) je-li zadaný výraz XPath nebyla namapována 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
Výraz XPath pro dotaz.

selectionNamespaces
Typ: System.Object
Řetězec oddělený mezerami, obsahující obory názvů odkazované v parametru XPath.Run-time chyba je generována, pokud jeden z určeného obory názvů nelze přeložit.

map
Typ: System.Object
An XmlMap.Pokud chcete dotaz XPath v konkrétní mapy, určete mapování XML.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Excel.Range
A Range objekt, který představuje buňky, které jsou mapovány na konkrétní XPath; nullodkaz null (Nothing v jazyce Visual Basic)je-li zadaný výraz 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 Tabulka XML jsou k dispozici pouze v aplikaci Microsoft Office Professional Edition 2003 a Microsoft Office Excel 2003.

Je-li cesta XPath existuje 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 parametrů naleznete v tématu Volitelné parametry v Office Solutions.

Příklady

Následující příklad kódu používá XmlDataQuery metodu pro získání Range buněk, které jsou mapovány na konkrétního jazyka XPath.

V tomto příkladu je úroveň dokument přizpůsobení.

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