Método WorksheetBase.XmlDataQuery
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, 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
- 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, ou se o intervalo mapeado está vazia.
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.
Se o XPath existe dentro de 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 usa o método de XmlDataQuery 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 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
- 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.