DocumentBase.SelectSingleNode(String, String, Boolean) Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Word

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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNode

Parametri

xPath: String

Stringa XPath valida. Per ulteriori informazioni su XPath, vedere la documentazione di riferimento XPath.

prefixMapping: String

Fornisce il prefisso nello schema in base a cui eseguire la ricerca. Usare il parametro se il PrefixMappingXPath parametro usa i nomi per cercare gli elementi.

fastSearchSkippingTextNodes: 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.

Restituisce

XMLNode

Oggetto XMLNode che rappresenta il primo nodo corrispondente al parametro XPath nel documento. null se non vengono trovati nodi corrispondenti al parametro XPath.

Esempio

Nell'esempio di codice seguente viene illustrato come specificare i XPath parametri e PrefixMapping quando si chiama il SelectSingleNode metodo. Per usare questo esempio, eseguirlo dalla ThisDocument classe in un progetto a livello di documento.

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

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

Commenti

L'impostazione del FastSearchSkippingTextNodes parametro per true ridurre le prestazioni perché Microsoft Office Word cerca tutti i nodi in un documento rispetto al testo contenuto nel nodo.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere parametri facoltativi nelle soluzioni Office.

Si applica a

Condividi tramite