Metodo WorksheetBase.XmlMapQuery

Articolo
08/11/2011

Ottiene un oggetto Range che rappresenta la celle mappate a un particolare XPath. Ottiene il valore nullriferimento null (Nothing in Visual Basic) se l'XPath specificato non è stato mappato al foglio di lavoro.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
Public Function XmlMapQuery ( _
    xPath As String, _
    selectionNamespaces As Object, _
    map As Object _
) As Range

public Range XmlMapQuery(
    string xPath,
    Object selectionNamespaces,
    Object map
)

Parametri

xPath
Tipo: System.String
XPath per il quale eseguire la query.

selectionNamespaces
Tipo: System.Object
Stringa delimitata da spazi che contiene gli spazi dei nomi ai quali viene fatto riferimento nel parametro XPath.Se uno degli spazi dei nomi specificati non può essere risolto, verrà generato un errore di runtime.

map
Tipo: System.Object
Oggetto XmlMap.Specificare una mappa XML se si desidera eseguire una query per l'XPath all'interno di una mappa specifica.

Valore restituito

Tipo: Microsoft.Office.Interop.Excel.Range
Oggetto Range che rappresenta le celle mappate a un particolare XPath; nullriferimento null (Nothing in Visual Basic) se l'XPath specificato non è stato mappato al foglio di lavoro.

Note

Le funzionalità XML, ad eccezione del salvataggio dei file nel formato Foglio di calcolo XML, sono disponibili solo in Microsoft Office Professional Edition 2003 e Microsoft Office Excel 2003.

A differenza del metodo XmlDataQuery, il metodo XmlMapQuery restituisce l'intera colonna di un elenco XML, incluse la riga di intestazione e la riga di inserimento.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene utilizzato il metodo XmlMapQuery per ottenere l'intervallo Range di celle mappato a un particolare XPath.

Questo esempio è valido per una personalizzazione a livello di documento.

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, missing);

    if (range1 == null)
    {
        MessageBox.Show("The specified XPath: '" + path +
            "' has not been mapped to the worksheet.");
    }
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

WorksheetBase Classe

Spazio dei nomi Microsoft.Office.Tools.Excel

Condividi tramite