Metodo DocumentBase.SelectSingleNode

Articolo
05/17/2013

Restituisce un oggetto Microsoft.Office.Interop.Word.XMLNode che rappresenta il primo nodo del documento che corrisponde al parametro XPath.

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 SelectSingleNode ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNode

public XMLNode SelectSingleNode(
    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.XMLNode
Oggetto Microsoft.Office.Interop.Word.XMLNode che rappresenta il primo nodo corrispondente al parametro XPath 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 SelectSingleNode.Per utilizzare questo esempio, eseguirlo dalla classe ThisDocument in un progetto a livello di documento.

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

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