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