XMLNode.SelectSingleNode メソッド
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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。