Método DocumentBase.SelectSingleNode

Artigo
05/21/2013

Retorna um objeto de Microsoft.Office.Interop.Word.XMLNode que representa o primeiro nó no documento que corresponde ao parâmetro de XPath .

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (em Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public Function SelectSingleNode ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNode

public XMLNode SelectSingleNode(
    string xPath,
    string prefixMapping,
    bool fastSearchSkippingTextNodes
)

Parâmetros

xPath
Tipo: System.String
Uma cadeia de caracteres XPath válida em.Para obter mais informações sobre XPath, consulte a referência XPath.

prefixMapping
Tipo: System.String
Fornece o prefixo no esquema para executar contra que a pesquisa.Use o parâmetro de PrefixMapping se o parâmetro de XPath usa nomes para procurar elementos.

fastSearchSkippingTextNodes
Tipo: System.Boolean
true vai todos os nós de texto ao procurar pelo nó especificado. false inclui nós de texto na pesquisa.O valor padrão é falso.

Valor de retorno

Tipo: Microsoft.Office.Interop.Word.XMLNode
Um objeto de Microsoft.Office.Interop.Word.XMLNode que representa o primeiro nó que corresponde ao parâmetro de XPath no documento; nulluma referência nula (Nothing no Visual Basic) se nenhum nó que corresponde ao parâmetro de XPath for encontrado.

Comentários

Defina o parâmetro de FastSearchSkippingTextNodes a true reduz o desempenho porque o Microsoft Office Word pesquisam todos os nós em um documento no texto contido no nó.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir demonstra como especificar os parâmetros de XPath e de PrefixMapping ao chamar o método de SelectSingleNode .Para usar este exemplo, ele execução da classe de ThisDocument em um projeto de um documento nível.

Private Sub DocumentSelectSingleNode()
    If Me.XMLSchemaReferences.Count > 0 Then
        Dim XPath As String = "/x:catalog/x:book/x:title"
        Dim PrefixMapping As String = "xmlns:x=""" + _
            Me.XMLSchemaReferences(1).NamespaceURI + """"
        Dim node As Word.XMLNode = Me.SelectSingleNode(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

private void DocumentSelectSingleNode()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;

        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences.get_Item(ref key).NamespaceURI +
            "\"";

        Word.XMLNode node = this.SelectSingleNode(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

DocumentBase Classe

Namespace Microsoft.Office.Tools.Word

Compartilhar via