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

定義

名前空間:

Microsoft.Office.Tools.Word

アセンブリ:

Microsoft.Office.Tools.Word.v4.0.Utilities.dll

XPath パラメーターと一致する、文書内の最初のノードを表す XMLNode オブジェクトを返します。

public Microsoft.Office.Interop.Word.XMLNode SelectSingleNode (string xPath, string prefixMapping, bool fastSearchSkippingTextNodes);

member this.SelectSingleNode : string * string * bool -> Microsoft.Office.Interop.Word.XMLNode

Public Function SelectSingleNode (xPath As String, Optional prefixMapping As String, Optional fastSearchSkippingTextNodes As Boolean) As XMLNode

パラメーター

xPath

String

有効な XPath 文字列です。 Xpath の詳細については、「XPath リファレンス」を参照してください。

prefixMapping

String

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

fastSearchSkippingTextNodes

Boolean

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

戻り値

XMLNode

文書内の XPath パラメーターと一致する最初のノードを表す XMLNode オブジェクト。XPath パラメーターと一致するノードが見つからない場合は null。

例

次のコード例では、 メソッドを呼び出すときに パラメーターと PrefixMapping パラメーターをXPath指定する方法をSelectSingleNode示します。 この例を使用するには、ドキュメント レベルのプロジェクトの ThisDocument クラスから実行します。

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

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

注釈

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

省略可能のパラメーター

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