XMLNode.SelectSingleNode – metoda

Článek
08/11/2011

Získává Microsoft.Office.Interop.Word.XMLNodeobjekt představující první podřízený uzel, který odpovídá XPathvparametr Microsoft.Office.Tools.Word.XMLNode řízení.

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 jazyka XPath.

PrefixMapping
Typ: System.String
Obsahuje předponu ve schéma proti kterému prohledávat.Použít PrefixMapping parametr Pokud vaše XPath parametr používá názvy vyhledávat prvky.

FastSearchSkippingTextNodes
Typ: System.Boolean
true přeskočit všechny uzly text při hledání zadaný uzel.falsezahrnout do vyhledávání textu uzlů.Výchozí hodnota je true.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Word.XMLNode
První podřízený uzel, který odpovídá XPathvparametr Microsoft.Office.Tools.Word.XMLNode řízení.

Poznámky

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

Volitelné parametry

Informace o volitelných parametrů, viz The Variable missing and Optional Parameters in Office Solutions.

Příklady

Následující kód například použití SelectSingleNode metoda podřízený uzel, který odpovídá dané XPath parametr. V příkladu 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 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é

Odkaz

XMLNode Rozhraní

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

Sdílet prostřednictvím