Udostępnij za pośrednictwem

Metoda WorksheetBase.XmlDataQuery —

  • Artykuł

Pobiera Range obiekt, który reprezentuje komórki zamapowane do określonej XPath.Pobiera nullodwołanie o wartości null (Nothing w języku Visual Basic) Jeśli określonym XPath nie zostało zamapowane do arkusza lub jeśli mapowanym zakresie jest pusta.

Przestrzeń nazw:  Microsoft.Office.Tools.Excel
Zestaw:  Microsoft.Office.Tools.Excel.v4.0.Utilities (w Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Składnia

'Deklaracja
Public Function XmlDataQuery ( _
    xPath As String, _
    selectionNamespaces As Object, _
    map As Object _
) As Range

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

Parametry

  • selectionNamespaces
    Typ: System.Object
    Rozdzielany spacjami ciąg, który zawiera obszary nazw, do których odwołuje się w parametrze XPath.Jeśli jeden z określonych obszarów nazw nie można rozpoznać, zostanie wygenerowany błąd w czasie wykonywania.
  • map
    Typ: System.Object
    An XmlMap.Umożliwia określenie mapę XML, jeśli chcesz wykonać kwerendę dla XPath w obrębie określonej mapy.

Wartość zwracana

Typ: Microsoft.Office.Interop.Excel.Range
A Range obiekt, który reprezentuje komórki zamapowane do określonej XPath; nullodwołanie o wartości null (Nothing w języku Visual Basic)Jeśli określonym XPath nie zostało zamapowane do arkusza lub mapowanym zakresie jest pusta.

Uwagi

Funkcje języka XML, oprócz zapisywania plików w formacie arkusza kalkulacyjnego XML, są dostępne tylko w programie Microsoft Office Professional Edition 2003 i Microsoft Office Excel 2003.

Jeśli wyrażenie XPath istnieje wewnątrz kolumny na liście XML, Range obiektu zwróconego nie zawiera wiersza nagłówka lub wiersza wstawiania.

Parametry opcjonalne

Aby uzyskać informacje o opcjonalnych parametrów, zobacz Parametry opcjonalne w rozwiązania dla pakietu Office.

Przykłady

Następujący kod w przykładzie wykorzystano XmlDataQuery sposób, aby Range komórek mapowany do określonego wyrażenie XPath.

Ten przykład dotyczy dostosowywania poziomie 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.");
    }
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

WorksheetBase Klasa

Przestrzeń nazw Microsoft.Office.Tools.Excel