DocumentBase.SelectNodes メソッド
XPath パラメーターと一致するノードを、文書で出現する順序で格納した Microsoft.Office.Interop.Word.XMLNodes コレクションを取得します。
名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word.v4.0.Utilities (Microsoft.Office.Tools.Word.v4.0.Utilities.dll 内)
構文
'宣言
Public Function SelectNodes ( _
xPath As String, _
prefixMapping As String, _
fastSearchSkippingTextNodes As Boolean _
) As XMLNodes
public XMLNodes SelectNodes(
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.XMLNodes
XPath パラメーターと一致するノードを、文書で出現する順序で格納した Microsoft.Office.Interop.Word.XMLNodes コレクション。XPath パラメーターと一致するノードが見つからない場合は nullnull 参照 (Visual Basic では Nothing)。
解説
FastSearchSkippingTextNodes パラメーターに true を設定するとパフォーマンスが低下します。Microsoft Office Word で、ノードに含まれるすべてのテキストを対象にして、文書内のすべてのノードを検索するためです。
省略可能なパラメーター
省略可能なパラメーターについては、「Office ソリューションの省略可能なパラメーター」を参照してください。
例
次のコード例では、SelectNodes メソッドを呼び出すときに、XPath パラメーターおよび PrefixMapping パラメーターを指定する方法を示しています。この例を使用するには、これをドキュメント レベルのプロジェクトの ThisDocument クラスから実行します。
Private Sub DocumentSelectNodes()
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.XMLNodes = Me.SelectNodes(XPath, _
PrefixMapping, True)
Else
MessageBox.Show("The document does not contain a " + _
"schema reference.")
End If
End Sub
private void DocumentSelectNodes()
{
if (this.XMLSchemaReferences.Count > 0)
{
string XPath = "/x:catalog/x:book/x:title";
object key = 1;
string PrefixMapping = "xmlns:x=\"" +
this.XMLSchemaReferences[key].NamespaceURI +
"\"";
Word.XMLNodes nodes = this.SelectNodes(XPath,
PrefixMapping, true);
}
else
{
MessageBox.Show("The document does not contain a " +
"schema reference.");
}
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。