WorksheetBase.XmlMapQuery(String, Object, Object) Método

Definição

Obtém um objeto Range que representa as células mapeadas para um XPath específico. Obterá o null se o XPath especificado não tiver sido mapeado para a planilha.

public Microsoft.Office.Interop.Excel.Range XmlMapQuery (string xPath, object selectionNamespaces, object map);

Parâmetros

xPath
String

O XPath de consulta.

selectionNamespaces
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
Object

Um XmlMap. Especifique um mapa XML caso você queira consultar o XPath em um mapa específico.

Retornos

Range

Um objeto Range que representa as células mapeadas para um XPath específico; null se o XPath especificado não tiver sido mapeado para a planilha.

Exemplos

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

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

private void WorksheetQueryXmlMap()
{
    string path = "/order/customer/address";
    string namespaces = "xmlns=http://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.");
    }
}
Private Sub WorksheetQueryXmlMap()
    Dim path As String = "/order/customer/address"
    Dim namespaces As String = "xmlns=http://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

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 XmlDataQuery método, o XmlMapQuery método retorna a coluna inteira de uma lista 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.

Aplica-se a