Metodo WorksheetBase.XmlDataQuery

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 oppure se l'intervallo mappato è vuoto.

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 XmlDataQuery ( _
    xPath As String, _
    selectionNamespaces As Object, _
    map As Object _
) As Range

public Range XmlDataQuery(
    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 oppure se l'intervallo mappato è vuoto.

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.

Se l'XPath esiste all'interno di una colonna in un elenco XML, l'oggetto Range restituito non include la riga di intestazione o 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 XmlDataQuery per ottenere l'intervallo Range di celle mappato a un particolare XPath.

Questo esempio è valido per una personalizzazione a livello di 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.");
    }
}

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