XMLNode.SelectSingleNode(String, String, Boolean) Metoda

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Word

Sestavení:: Microsoft.Office.Tools.Word.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

XMLNode Získá objekt, který představuje první podřízený uzel, který odpovídá XPath parametru v ovládacím XMLNode prvku.

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);

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

Public Function SelectSingleNode (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNode

Parametry

XPath: String

Platný řetězec XPath

PrefixMapping: String

Poskytuje předponu ve schématu, oproti kterému se má vyhledávat. Parametr použijte, PrefixMapping pokud parametr XPath používá k hledání prvků názvy.

FastSearchSkippingTextNodes: Boolean

true při hledání zadaného uzlu přeskočíte všechny textové uzly. false a zahrnout do hledání textové uzly. Výchozí hodnota je true.

Návraty

XMLNode

První podřízený uzel, který odpovídá parametru XPath v ovládacím XMLNode prvku.

Příklady

Následující příklad kódu používá metodu SelectSingleNode k získání podřízeného uzlu, který odpovídá danému XPath parametru. Příklad pak zobrazí název nalezeného uzlu. Tento příklad předpokládá, že aktuální dokument obsahuje pojmenovaný XMLNodeCustomerNode s odpovídajícím prvkem schématu, který obsahuje jeden nebo více podřízených uzlů s názvem LastName.

private void FindLastNameNode()
{
    string element = "/x:Customer/x:LastName";
    string prefix = "xmlns:x='" + 
        this.CustomerLastNameNode.NamespaceURI + "'";

    Word.XMLNode node = this.CustomerNode.SelectSingleNode(element,
        prefix, true);
    if (node != null)
    {
        MessageBox.Show(node.BaseName + " element was found.");
    }
    else
    {
        MessageBox.Show("The requested node was not found.");
    }
}

Private Sub FindLastNameNode()
    Dim element As String = "/x:Customer/x:LastName"
    Dim prefix As String = "xmlns:x='" & _
        Me.CustomerLastNameNode.NamespaceURI & "'"

    Dim node As Word.XMLNode = _
        Me.CustomerNode.SelectSingleNode(element, prefix, True)
    If node IsNot Nothing Then
        MsgBox(node.BaseName & " element was found.")
    Else
        MsgBox("The requested node was not found.")
    End If
End Sub

Poznámky

Nastavení parametru FastSearchSkippingTextNodes na false snížení výkonu, protože Microsoft Office Word hledá text obsažený v uzlu na všech uzlech v dokumentu.

Volitelné parametry

Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro Systém Office.

Platí pro

Sdílet prostřednictvím