Compartilhar via


Método WorksheetBase.XmlDataQuery

Obtém um objeto de Range que representa as células mapeadas para um XPath específico.Obtém nulluma referência nula (Nothing no Visual Basic) se o XPath especificado não esteve mapeado para a planilha, ou se o intervalo mapeado está vazia.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public Function XmlDataQuery ( _
    xPath As String, _
    selectionNamespaces As Object, _
    map As Object _
) As Range
public Range XmlDataQuery(
    string xPath,
    Object selectionNamespaces,
    Object map
)

Parâmetros

  • selectionNamespaces
    Tipo: System.Object
    Uma cadeia de caracteres com delimitação espacial que contém os namespaces referenciada no parâmetro XPath.Um erro em tempo de execução é gerado se uma namespaces especificados não pode ser resolvido.
  • map
    Tipo: System.Object
    XmlMap .Especificar um mapa de XML se você desejar consultar o que em um mapa específico.

Valor de retorno

Tipo: Microsoft.Office.Interop.Excel.Range
Um objeto de Range que representa as células mapeado para um XPath específica; nulluma referência nula (Nothing no Visual Basic) se o XPath especificado não esteve mapeado para a planilha, ou se o intervalo mapeado está vazia.

Comentários

Recursos XML, exceto para salvamento de arquivo no formato a planilha XML, estão disponíveis somente na edição do Microsoft Office 2003 Professional e no Microsoft Office Excel 2003.

Se o que existe em uma coluna em uma lista de XML, o objeto de Range retornado não inclui a linha de cabeçalho ou a linha de inserção.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir usa o método de XmlDataQuery para obter Range das células mapeadas para um XPath específico.

Este exemplo é para uma personalização da nível.

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.");
    }
}

Segurança do .NET Framework

Consulte também

Referência

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel