Metodo XMLNode.SelectSingleNode

Articolo
08/11/2011

Ottiene un oggetto Microsoft.Office.Interop.Word.XMLNode che rappresenta il primo nodo figlio corrispondente al parametro XPath 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 SelectSingleNode ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNode

XMLNode SelectSingleNode(
    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 è true.

Valore restituito

Tipo: Microsoft.Office.Interop.Word.XMLNode
Primo nodo figlio che corrisponde al parametro XPath 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 SelectSingleNode per ottenere un nodo figlio corrispondente al parametro XPath specificato. Viene quindi visualizzato il nome del nodo trovato. 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 LastName.

Private Sub FindLastNameNode()
    Dim element As String = "/x:Customer/x:LastName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerLastNameNode.NamespaceURI & "'"

    Dim node As Word.XMLNode = _
        Me.CustomerNode.SelectSingleNode(element, prefix, True)
    If node IsNot Nothing Then
        MsgBox(node.BaseName & " element was found.")
    Else
        MsgBox("The requested node was not found.")
    End If
End Sub

private void FindLastNameNode()
{
    string element = "/x:Customer/x:LastName";
    string prefix = "xmlns:x='" + 
        this.CustomerLastNameNode.NamespaceURI + "'";

    Word.XMLNode node = this.CustomerNode.SelectSingleNode(element,
        prefix, true);
    if (node != null)
    {
        MessageBox.Show(node.BaseName + " element was found.");
    }
    else
    {
        MessageBox.Show("The requested node was not 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