Microsoft.Office.Tools.Word.XMLNode コントロール内でXPath パラメーターに一致する最初の子ノードを表す Microsoft.Office.Interop.Word.XMLNode オブジェクトを取得します。
名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll 内)
構文
'宣言
Function SelectSingleNode ( _
XPath As String, _
PrefixMapping As String, _
FastSearchSkippingTextNodes As Boolean _
) As XMLNode
XMLNode SelectSingleNode(
string XPath,
string PrefixMapping,
bool FastSearchSkippingTextNodes
)
パラメーター
- XPath
型: System.String
有効な XPath 文字列。
- PrefixMapping
型: System.String
検索を実行する対象のスキーマ内でプレフィックスを利用できるようにします。名前を使用して要素を検索するように XPath パラメーターを指定する場合は、PrefixMapping パラメーターを使用してください。
- FastSearchSkippingTextNodes
型: System.Boolean
指定されたノードを検索している間、すべてのテキスト ノードをスキップする場合は true。テキスト ノードを含めて検索する場合は false。既定値は trueです。
戻り値
型: Microsoft.Office.Interop.Word.XMLNode
Microsoft.Office.Tools.Word.XMLNode コントロール内で、XPath パラメーターに一致する最初の子ノード。
解説
FastSearchSkippingTextNodes パラメーターに false を設定すると、Microsoft Office Word は文書内のすべてのノードを検索してノードに含まれるテキストを調べるため、パフォーマンスが低下します。
省略可能なパラメーター
省略可能なパラメーターについては、「Office ソリューションの省略可能なパラメーター」を参照してください。
例
次のコード例は SelectSingleNode メソッドを使用して、指定の XPath パラメーターに一致する子ノードを取得します。 その後、検出されたノードの名前を表示します。 この例では、現在の文書が CustomerNode という名前の XMLNode を含み、このスキーマ要素がパラメーターに一致して、LastName という名前の子ノードを 1 つ以上含むことが前提となっています。
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
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.");
}
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。 このメンバーは、部分的に信頼されているコードから使用することはできません。 詳細については、「部分信頼コードからのライブラリの使用」を参照してください。