Aracılığıyla paylaş


XMLNode.SelectSingleNode(String, String, Boolean) Yöntem

Tanım

Denetimdeki parametreyle XMLNode eşleşen XPath ilk alt düğümü temsil eden bir XMLNode nesnesi alır.

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string XPath, string PrefixMapping = "", bool FastSearchSkippingTextNodes = true);
abstract member SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode
Public Function SelectSingleNode (XPath As String, Optional PrefixMapping As String = "", Optional FastSearchSkippingTextNodes As Boolean = true) As XMLNode

Parametreler

XPath
String

Geçerli bir XPath dizesi.

PrefixMapping
String

Arama gerçekleştirilecek şemaya önek sağlar. PrefixMapping Parametreniz XPath öğeleri aramak için adları kullanıyorsa parametresini kullanın.

FastSearchSkippingTextNodes
Boolean

true öğesini seçerek belirtilen düğümü ararken tüm metin düğümlerini atlayın. false aramasına metin düğümleri eklemek için. Varsayılan değer true olarak belirlenmiştir.

Döndürülenler

Denetimdeki XMLNode parametreyle XPath eşleşen ilk alt düğüm.

Örnekler

Aşağıdaki kod örneği, belirtilen XPath parametreyle SelectSingleNode eşleşen bir alt düğüm almak için yöntemini kullanır. Örnek daha sonra bulunan düğümün adını görüntüler. Bu örnekte, geçerli belgenin adlı CustomerNode bir XMLNode veya daha fazla alt düğüm içeren eşleşen bir şema öğesi ile adlandırılmış olduğunu LastNamevarsayar.

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

Açıklamalar

FastSearchSkippingTextNodes Microsoft Office Word bir belgedeki tüm düğümlerde düğümde yer alan metni ararken parametrenin false ayarlanması performansı azaltıyor.

İsteğe Bağlı Parametreler

İsteğe bağlı parametreler hakkında bilgi için bkz. Office Çözümleri'nde İsteğe Bağlı Parametreler.

Şunlara uygulanır