Metodo DocumentBase.SelectNodes

Articolo
08/11/2011

Ottiene un insieme di Microsoft.Office.Interop.Word.XMLNodes che rappresenta tutti i nodi corrispondenti al parametro XPath nell'ordine in cui vengono visualizzati nel documento.

Spazio dei nomi: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v4.0.Utilities (in Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Sintassi

'Dichiarazione
Public Function SelectNodes ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNodes

public XMLNodes SelectNodes(
    string xPath,
    string prefixMapping,
    bool fastSearchSkippingTextNodes
)

Parametri

xPath
Tipo: System.String
Stringa XPath valida.Per ulteriori informazioni su XPath, vedere la documentazione di riferimento XPath.

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 include i nodi di testo nella ricerca.Il valore predefinito è false.

Valore restituito

Tipo: Microsoft.Office.Interop.Word.XMLNodes
Insieme Microsoft.Office.Interop.Word.XMLNodes che rappresenta tutti i nodi corrispondenti al parametro XPath nell'ordine in cui vengono visualizzati nel documento. nullriferimento null (Nothing in Visual Basic) se non vengono trovati nodi corrispondenti al parametro XPath.

Note

L'impostazione del parametro FastSearchSkippingTextNodes su true riduce le prestazioni in quanto in Microsoft Office Word il testo contenuto nel nodo viene cercato 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 riportato di seguito viene illustrato come specificare i parametri XPath e PrefixMapping quando viene chiamato il metodo SelectNodes. Per utilizzare questo esempio, eseguirlo dalla classe ThisDocument in un progetto a livello di documento.

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

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

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

DocumentBase Classe

Spazio dei nomi Microsoft.Office.Tools.Word

Condividi tramite