XMLNode.SelectSingleNode 方法
取得 Microsoft.Office.Interop.Word.XMLNode 物件，代表第一個符合 Microsoft.Office.Tools.Word.XMLNode 控制項中 XPath 參數的子節點。
命名空間： 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 參數的第一個子節點。
備註
因為 Microsoft Office Word 會在文件的所有節點中搜尋包含在節點內的文字，所以將 FastSearchSkippingTextNodes 參數設定為 false 會減低效能。
選擇性參數
如需選擇性參數的詳細資訊，請參閱Office 方案中的選擇性參數。
範例
下列程式碼範例使用 SelectSingleNode 方法，取得符合指定的 XPath 參數的子節點。 然後範例便會顯示找到的節點名稱。 這個範例假設目前文件包含有名為 CustomerNode 的 XMLNode，該節點包含了一個或多個名為 LastName 的子節點。
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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。