XMLNode.SelectSingleNode – metoda

Článek
01/03/2014

Získá Microsoft.Office.Interop.Word.XMLNode objekt představující první podřízený uzel, který odpovídá XPath parametr Microsoft.Office.Tools.Word.XMLNode ovládacího prvku.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

'Deklarace
Function SelectSingleNode ( _
    XPath As String, _
    PrefixMapping As String, _
    FastSearchSkippingTextNodes As Boolean _
) As XMLNode

XMLNode SelectSingleNode(
    string XPath,
    string PrefixMapping,
    bool FastSearchSkippingTextNodes
)

Parametry

XPath
Typ: System.String
Platný řetězec XPath

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

FastSearchSkippingTextNodes
Typ: System.Boolean
true Chcete-li přeskočit všechny uzly text při hledání pro zadaný uzel. false Chcete-li zahrnout hledání textové uzly.Výchozí hodnota je true.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Word.XMLNode
První podřízený uzel, který odpovídá XPath parametr Microsoft.Office.Tools.Word.XMLNode ovládacího prvku.

Poznámky

Nastavení FastSearchSkippingTextNodes parametr false snižuje výkon, protože aplikace Microsoft Office Word vyhledá všechny uzly v dokumentu text obsažený v uzlu.

Volitelné parametry

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

Příklady

Následující příklad kódu používá SelectSingleNode metoda získat podřízený uzel, který odpovídá dané XPath parametr.Příkladu se potom zobrazí název uzlu, který nebyl nalezen.Tento příklad předpokládá, že obsahuje aktuální dokument XMLNode s názvem CustomerNode s odpovídající prvek schématu, který obsahuje jeden nebo více podřízených uzlů s názvem LastName.

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

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

XMLNode Rozhraní

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím