WorksheetBase.XmlMapQuery, 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.
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 XmlMapQuery ( _
xPath As String, _
selectionNamespaces As Object, _
map As Object _
) As Range
public Range XmlMapQuery(
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.
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.
Contrairement à la méthode XmlDataQuery, la méthode XmlMapQuery retourne la colonne entière d'une liste XML, y compris la ligne d'en-tête et 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 XmlMapQuery pour obtenir le Range de cellules mappées à un XPath particulier.
Cet exemple illustre une personnalisation au niveau du document.
Private Sub WorksheetQueryXmlMap()
Dim path As String = "/order/customer/address"
Dim namespaces As String = "xmlns=https://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
private void WorksheetQueryXmlMap()
{
string path = "/order/customer/address";
string namespaces = "xmlns=https://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.");
}
}
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.