WorksheetBase.XmlDataQuery (Método)
Obtiene un objeto Range que representa las celdas asignadas a un elemento XPath determinado. Obtiene nullreferencia null (Nothing en Visual Basic) si el elemento XPath especificado no se ha asignado a la hoja de cálculo o si el rango asignado está vacío.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel.v4.0.Utilities (en Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Sintaxis
'Declaración
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
XPath que se consulta.
- selectionNamespaces
Tipo: System.Object
Una cadena delimitada por espacio que contiene los espacios de nombres a los que se hace referencia en el parámetro XPath.Si no se puede resolver uno de los espacios de nombres especificados, se genera un error en tiempo de ejecución.
- map
Tipo: System.Object
Objeto XmlMap.Especifique un mapa de XML si desea consultar el elemento XPath dentro de un mapa concreto.
Valor devuelto
Tipo: Microsoft.Office.Interop.Excel.Range
Objeto Range que representa las celdas asignadas a un elemento XPath determinado; nullreferencia null (Nothing en Visual Basic) si el elemento XPath especificado no se ha asignado a la hoja de cálculo o si el rango asignado está vacío.
Comentarios
Las características de XML, salvo para guardar archivos en formato de hoja de cálculo XML, sólo están disponibles en Microsoft Office Professional 2003 y Microsoft Office Excel 2003.
Si el elemento XPath existe en una columna de una lista XML, el objeto Range devuelto no incluye la fila de encabezado ni la fila de inserción.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
En el ejemplo de código siguiente se utiliza el método XmlDataQuery para obtener el objeto Range de las celdas asignadas a un elemento XPath determinado.
Se trata de un ejemplo para una personalización en el nivel del 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.");
}
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.