Método WorksheetBase.XmlMapQuery

Artigo
01/09/2014

Obtém um objeto 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 foi mapeado para a planilha.

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

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

Parâmetros

xPath
Tipo: System.String
O XPath de consulta.

selectionNamespaces
Tipo: System.Object
Uma cadeia de caracteres delimitada por espaço que contém os namespaces referenciados no parâmetro XPath.Um erro de tempo de execução é gerado caso um dos namespaces especificados não possa ser resolvido.

map
Tipo: System.Object
Um XmlMap.Especifique um mapa XML caso você queira consultar o XPath 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 foi mapeado para a planilha.

Comentários

Recursos XML, exceto para salvar arquivos no formato da planilha XML, só estão disponíveis na edição no Microsoft Office Professional Edition 2003 e no Microsoft Office Excel 2003.

Ao contrário do método de XmlDataQuery , o método de XmlMapQuery retorna a coluna inteira de uma lista de XML, incluindo a linha de cabeçalho e 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 usa o método de XmlMapQuery para obter Range das células mapeadas para um XPath específico.

Este exemplo destina-se a uma personalização no nível de documento.

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

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

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

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

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

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via