DocumentBase.SelectSingleNode – metoda

Článek
05/14/2013

Vrátí Microsoft.Office.Interop.Word.XMLNode objekt, který představuje první uzel 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 výraz XPath.Další informace o XPath naleznete v tématu Reference jazyka 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 přeskočí všechny textové uzly při hledání pro zadaný uzel. false obsahuje text uzly v hledání.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 odpovídající XPath parametru jsou nalezeny.

Poznámky

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

Příklady

Následující příklad kódu ukazuje, jak určit, XPath a PrefixMapping parametry při volání SelectSingleNode metoda.Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy 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