XMLNode.SelectSingleNode(String, String, Boolean) メソッド

定義

名前空間:

Microsoft.Office.Tools.Word

アセンブリ:

Microsoft.Office.Tools.Word.dll

XMLNode コントロール内でXPath パラメーターに一致する最初の子ノードを表す XMLNode オブジェクトを取得します。

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

パラメーター

XPath

String

有効な XPath 文字列です。

PrefixMapping

String

検索対象のスキーマのプレフィックスを指定します。 パラメーターで名前を PrefixMapping 使用して要素を XPath 検索する場合は、 パラメーターを使用します。

FastSearchSkippingTextNodes

Boolean

指定されたノードを検索している間、すべてのテキスト ノードをスキップする場合は true。 テキスト ノードを含めて検索する場合は false。 既定値は trueにする必要があります。

戻り値

XMLNode

XMLNode コントロール内で、XPath パラメーターに一致する最初の子ノード。

例

次のコード例では、 メソッドを SelectSingleNode 使用して、指定 XPath されたパラメーターに一致する子ノードを取得します。 次に、検出されたノードの名前を表示します。 この例では、現在のドキュメント XMLNode に、 という名前 CustomerNode の 1 つ以上の子ノードを含む、一致するスキーマ要素を持つ という名前の LastNameが含まれていることを前提としています。

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

注釈

パラメーターを FastSearchSkippingTextNodes にfalse設定すると、Microsoft Office Wordは、ドキュメント内のすべてのノードでノードに含まれるテキストを検索するため、パフォーマンスが低下します。

省略可能のパラメーター

省略可能なパラメーターの詳細については、「 Office ソリューションの省略可能なパラメーター」を参照してください。