Condividi tramite


XMLNode.SelectSingleNode(String, String, Boolean) Metodo

Definizione

Ottiene un oggetto XMLNode che rappresenta il primo nodo figlio corrispondente al parametro XPath nel controllo XMLNode.

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);
abstract member SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode
Public Function SelectSingleNode (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNode

Parametri

XPath
String

Stringa XPath valida.

PrefixMapping
String

Fornisce il prefisso nello schema in base a cui eseguire la ricerca. Usare il PrefixMapping parametro se il XPath parametro usa i nomi per cercare gli elementi.

FastSearchSkippingTextNodes
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.

Restituisce

Primo nodo figlio che corrisponde al parametro XPath nel controllo XMLNode.

Esempio

Nell'esempio di codice seguente viene usato il SelectSingleNode metodo per ottenere un nodo figlio corrispondente al parametro specificato XPath . Nell'esempio viene quindi visualizzato il nome del nodo trovato. In questo esempio si presuppone che il documento corrente contenga un XMLNode oggetto denominato CustomerNode con un elemento dello schema corrispondente che contiene uno o più nodi figlio denominati LastName.

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.");
    }
}
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

Commenti

L'impostazione del FastSearchSkippingTextNodes parametro per false ridurre le prestazioni perché Microsoft Office Word cerca il testo contenuto nel nodo in tutti i nodi di un documento.

Parametri facoltativi

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

Si applica a