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

Başvuru

Tanım

Ad Alanı:: Microsoft.Office.Tools.Word

Bütünleştirilmiş Kod:: Microsoft.Office.Tools.Word.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

XMLNode

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

Aracılığıyla paylaş