WorksheetBase.XmlMapQuery(String, Object, Object) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.