DocumentBase.SelectNodes(String, String, Boolean) Método

Referência

Definição

Namespace:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.v4.0.Utilities.dll

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.

Obtém uma coleção XMLNodes que representa todos os nós que correspondem ao parâmetro XPath na ordem em que são exibidos no documento.

public Microsoft.Office.Interop.Word.XMLNodes SelectNodes (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectNodes : string * string * bool -> Microsoft.Office.Interop.Word.XMLNodes

Public Function SelectNodes (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNodes

Parâmetros

xPath: String

Uma cadeia de caracteres XPath válida. Para obter mais informações sobre o XPath, consulte a Referência do XPath.

prefixMapping: String

Fornece o prefixo no esquema no qual a pesquisa deve ser realizada. Use o parâmetro se o PrefixMappingXPath parâmetro usar nomes para pesquisar elementos.

fastSearchSkippingTextNodes: Boolean

true ignora todos os nós de texto ao procurar o nó especificado. false inclui nós de texto na pesquisa. O valor padrão é false.

Retornos

XMLNodes

Uma coleção XMLNodes que representa todos os nós que correspondem ao parâmetro XPath na ordem em que são exibidos no documento; null se não for encontrado nenhum nó que corresponde ao parâmetro XPath.

Exemplos

O exemplo de código a seguir demonstra como especificar os XPath parâmetros e PrefixMapping ao chamar o SelectNodes método . Para usar esse exemplo, execute-o na classe ThisDocument em um projeto no nível de documento.

private void DocumentSelectNodes()
{
    if (this.XMLSchemaReferences.Count > 0)
    {
        string XPath = "/x:catalog/x:book/x:title";
        object key = 1;
        string PrefixMapping = "xmlns:x=\"" +
            this.XMLSchemaReferences[key].NamespaceURI +
            "\"";
        Word.XMLNodes nodes = this.SelectNodes(XPath, 
            PrefixMapping, true);
    }
    else
    {
        MessageBox.Show("The document does not contain a " +
            "schema reference.");
    }
}

Private Sub DocumentSelectNodes()
    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.XMLNodes = Me.SelectNodes(XPath, _
            PrefixMapping, True)
    Else
        MessageBox.Show("The document does not contain a " + _
            "schema reference.")
    End If
End Sub

Comentários

Definir o parâmetro como true diminui o FastSearchSkippingTextNodes desempenho, pois o Microsoft Office Word pesquisa todos os nós em um documento em relação ao texto contido no nó.

Parâmetros Opcionais

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

Aplica-se a

Compartilhar via