DocumentBase.SelectSingleNode – metoda

Článek
01/03/2014

Vrátí Microsoft.Office.Interop.Word.XMLNode objekt, který představuje prvním uzlem v dokumentu, který odpovídá XPath parametr.

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

Syntaxe

'Deklarace
Public Function SelectSingleNode ( _
    xPath As String, _
    prefixMapping As String, _
    fastSearchSkippingTextNodes As Boolean _
) As XMLNode

public XMLNode SelectSingleNode(
    string xPath,
    string prefixMapping,
    bool fastSearchSkippingTextNodes
)

Parametry

xPath
Typ: System.String
Platný řetězec XPathDalší informace o XPath naleznete v tématu Reference jazyka 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
Hodnota true přeskočí při hledání zadaného uzlu všechny textové uzly. false zahrne do vyhledávání textové uzly.Výchozí hodnota je false.

Vrácená hodnota

Typ: Microsoft.Office.Interop.Word.XMLNode
A Microsoft.Office.Interop.Word.XMLNode objekt, který představuje první uzel, který odpovídá XPath parametr v dokumentu. nullodkaz null (Nothing v jazyce Visual Basic)Pokud žádné uzly shodující se XPath parametr se nacházejí.

Poznámky

Nastavení FastSearchSkippingTextNodes parametr true snižuje výkon, protože aplikace Microsoft Office Word vyhledá všechny uzly v dokumentu proti 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 ukazuje, jak zadat XPath a PrefixMapping parametrů při volání SelectSingleNode metody.Chcete-li tento příklad použít, spusťte jej ze třídy ThisDocument v projektu na úrovni dokumentu.

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

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

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

DocumentBase Třída

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

Sdílet prostřednictvím