WorksheetBase.XmlDataQuery, méthode
Obtient un objet Range qui représente les cellules mappées à un XPath particulier. Obtient nullune référence null (Nothing en Visual Basic) si le XPath spécifié n'a pas été mappé vers la feuille de calcul, ou si la plage mappée est vide.
Espace de noms : Microsoft.Office.Tools.Excel
Assembly : Microsoft.Office.Tools.Excel.v4.0.Utilities (dans Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Syntaxe
'Déclaration
Public Function XmlDataQuery ( _
xPath As String, _
selectionNamespaces As Object, _
map As Object _
) As Range
public Range XmlDataQuery(
string xPath,
Object selectionNamespaces,
Object map
)
Paramètres
- xPath
Type : System.String
Le XPath à interroger.
- selectionNamespaces
Type : System.Object
Une chaîne délimitée par des espaces, qui contient les espaces de noms référencés dans le paramètre XPath.Une erreur d'exécution est générée si l'un des espaces de noms spécifiés ne peut pas être résolu.
- map
Type : System.Object
Élément XmlMap.Spécifiez un mappage XML si vous souhaitez interroger le XPath dans un mappage spécifique.
Valeur de retour
Type : Microsoft.Office.Interop.Excel.Range
Un objet Range qui représente les cellules mappées à un XPath particulier ; nullune référence null (Nothing en Visual Basic) si le XPath spécifié n'a pas été mappé vers la feuille de calcul, ou si la plage mappée est vide.
Notes
Les fonctionnalités XML, à l'exception de celles utilisées pour enregistrer des fichiers au format de feuille de calcul XML, sont disponibles uniquement dans Microsoft Office Édition Professionnelle 2003 et Microsoft Office Excel 2003.
Si le XPath existe dans une colonne d'une liste XML, l'objet Range retourné n'inclut pas la ligne d'en-tête ou la ligne d'insertion.
Paramètres optionnels
Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.
Exemples
L'exemple de code suivant utilise la méthode XmlDataQuery pour obtenir le Range des cellules mappées à un XPath particulier.
Cet exemple illustre une personnalisation au niveau du document.
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.");
}
}
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.