Metodo XMLNode.SelectNodes

Articolo
08/11/2011

Ottiene un insieme Microsoft.Office.Interop.Word.XMLNodes che rappresenta tutti i nodi corrispondenti al parametro XPath nell'ordine in cui vengono visualizzati nel controllo Microsoft.Office.Tools.Word.XMLNode.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Sintassi

'Dichiarazione
Function SelectNodes ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNodes

XMLNodes SelectNodes(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Parametri

XPath
Tipo: System.String
Stringa XPath valida.

PrefixMapping
Tipo: System.String
Fornisce il prefisso nello schema in base a cui eseguire la ricerca.Utilizzare il parametro PrefixMapping se il parametro XPath utilizza nomi per la ricerca di elementi.

FastSearchSkippingTextNodes
Tipo: System.Boolean
true per ignorare tutti i nodi di testo durante la ricerca del nodo specificato.false per includere i nodi di testo nella ricerca.Il valore predefinito è false.

Valore restituito

Tipo: Microsoft.Office.Interop.Word.XMLNodes
Nodi corrispondenti al parametro XPath nell'ordine in cui vengono visualizzati nel controllo Microsoft.Office.Tools.Word.XMLNode.

Note

L'impostazione del parametro FastSearchSkippingTextNodes su false riduce le prestazioni in quanto in Microsoft Office Word il testo contenuto nel nodo viene ricercato in tutti i nodi di un documento.

Parametri facoltativi

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

Esempi

Nell'esempio di codice seguente viene utilizzato il metodo SelectNodes per ottenere un insieme dei nodi figlio corrispondenti al parametro XPath specificato. Viene quindi visualizzato il numero di nodi trovati. In questo esempio si suppone che il documento corrente contenga un oggetto XMLNode denominato CustomerNode con un elemento di schema corrispondente che contiene uno o più nodi figlio denominati FirstName.

Private Sub DisplayFirstNameNodesCount()
    Dim element As String = "/x:Customer/x:FirstName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerFirstNameNode.NamespaceURI & "'"

    Dim nodes As Word.XMLNodes = _
        Me.CustomerNode.SelectNodes(element, prefix, True)
    MsgBox(nodes.Count & " element(s) were found.")
End Sub

private void DisplayFirstNameNodesCount()
{
    string element = "/x:Customer/x:FirstName";
    string prefix = "xmlns:x='" + 
        this.CustomerFirstNameNode.NamespaceURI + "'";

    Word.XMLNodes nodes = this.CustomerNode.SelectNodes(element, 
        prefix, true);
    MessageBox.Show(nodes.Count + " element(s) were found.");
}

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

XMLNode Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite