Método WorksheetBase.XmlDataQuery
Obtém um Range objeto 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 estiver vazio.
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 para consultar.
- selectionNamespaces
Tipo: System.Object
Uma string delimitada que contém os espaços para nome referenciados no parâmetro XPath.Um erro em tempo de execução é gerado se um dos espaços para nome especificados não puder ser resolvido.
- map
Tipo: System.Object
An XmlMap.Se você deseja consultar o XPath dentro de um mapa específico, especifique um mapa XML.
Valor de retorno
Tipo: Microsoft.Office.Interop.Excel.Range
A Range objeto que representa as células mapeadas para um XPath específico; nulluma referência nula (Nothing no Visual Basic)Se o XPath especificado não foi mapeado para a planilha ou intervalo mapeado estiver vazio.
Comentários
Recursos XML, exceto para salvar arquivos no formato planilha XML, estão disponíveis somente no Microsoft Office Professional Edition 2003 e Excel 2003 do Microsoft Office.
Se o XPath estiver dentro de uma coluna em uma lista XML, o Range objeto retornado não inclui a linha de cabeçalho ou a linha de inserção.
Optional Parameters
Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.
Exemplos
O seguinte exemplo de código usa a XmlDataQuery método para obter o Range das células mapeado para um XPath específico.
Este exemplo é para uma personalização em 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, missing);
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áveis.