XMLNode.SelectSingleNode(String, String, Boolean) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);
Parâmetros
- XPath
- String
Uma cadeia de caracteres XPath válida.
- PrefixMapping
- String
Fornece o prefixo no esquema no qual a pesquisa deve ser realizada. Use o parâmetro PrefixMapping caso o parâmetro XPath use nomes para pesquisar elementos.
- FastSearchSkippingTextNodes
- Boolean
true para ignorar todos os nós de texto ao pesquisar o nó especificado. false para incluir nós de texto na pesquisa. O valor padrão é true.
Retornos
O primeiro nó filho que corresponde ao parâmetro XPath no controle XMLNode.
Exemplos
O exemplo de código a seguir usa o SelectSingleNode método para obter um nó filho que corresponde ao XPath parâmetro fornecido. Em seguida, o exemplo exibe o nome do nó que foi encontrado. Este exemplo pressupõe que o documento atual contém um XMLNode chamado CustomerNode com um elemento de esquema correspondente que contém um ou mais nós filho denominados 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
Comentários
Definir o FastSearchSkippingTextNodes parâmetro para false diminui o desempenho porque Microsoft Office Word pesquisa todos os nós em um documento para o texto contido no nó.
Parâmetros opcionais
Para obter informações sobre parâmetros opcionais, consulte parâmetros opcionais em soluções do Office.