XMLNode.SelectSingleNode – metoda

Článek
05/14/2013

Získá Microsoft.Office.Interop.Word.XMLNode objekt, který představuje první podřízený uzel, který odpovídá XPath parametr v 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 výraz XPath.

PrefixMapping
Typ: System.String
Poskytuje předponu ve schématu, proti kterému chcete-li provést hledání.Použití PrefixMapping parametr-li vaše XPath parametr používá názvy hledání prvků.

FastSearchSkippingTextNodes
Typ: System.Boolean
true Chcete-li přeskočit všechny textové uzly při hledání pro zadaný uzel. false Chcete-li při hledání zahrnout 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 v Microsoft.Office.Tools.Word.XMLNode ovládacího prvku.

Poznámky

Nastavení FastSearchSkippingTextNodes parametr false nesniž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 parametrů naleznete v tématu Volitelné parametry v Office Solutions.

Příklady

Následující příklad kódu používá SelectSingleNode metodu pro získání podřízený uzel, který odpovídá daném 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