XMLNode 介面

表示文件上的單一 XML 節點，此節點會公開事件而且可以繫結至資料。

命名空間：  Microsoft.Office.Tools.Word
組件：  Microsoft.Office.Tools.Word (在 Microsoft.Office.Tools.Word.dll 中)

語法

'宣告
<GuidAttribute("29b82cde-df64-4c6f-a64f-87561e588ecb")> _
Public Interface XMLNode _
    Inherits IBindableComponent, IComponent, IDisposable, ISupportInitialize

[GuidAttribute("29b82cde-df64-4c6f-a64f-87561e588ecb")]
public interface XMLNode : IBindableComponent, 
    IComponent, IDisposable, ISupportInitialize

XMLNode 型別會公開下列成員。

屬性

	名稱	說明
	Application	取得 Application，表示 XMLNode 控制項的建立者。
	Attributes	取得 Microsoft.Office.Interop.Word.XMLNodes 集合，表示 XMLNode 控制項的屬性。
	BaseName	取得沒有任何前置字串的 XMLNode 控制項名稱。
	BindingContext	取得或設定 IBindableComponent 的 Currency 管理員集合。 (繼承自 IBindableComponent)。
	ChildNodes	取得 Microsoft.Office.Interop.Word.XMLNodes 集合，表示 XMLNode 控制項的子項目。
	ChildNodeSuggestions	取得 XMLChildNodeSuggestions 集合，表示可能是目前 XMLNode 控制項有效子系的項目。
	Container	基礎架構。
	Creator	取得建立 XMLNode 控制項的應用程式。
	DataBindings	取得這個 IBindableComponent 的資料繫結物件集合。 (繼承自 IBindableComponent)。
	DefaultDataSourceUpdateMode	取得或設定 XMLNode 的預設 DataSourceUpdateMode。
	FirstChild	取得 Microsoft.Office.Interop.Word.XMLNode 物件，表示在 Microsoft.Office.Tools.Word.XMLNode 控制項中的第一個子節點。
	HasChildNodes	取得值，指出 XMLNode 控制項是否有子項目。
	InnerObject	取得 Microsoft.Office.Interop.Word.XMLNode，表示 XMLNode 的基礎原生物件。
	LastChild	取得 Microsoft.Office.Interop.Word.XMLNode 物件，表示 Microsoft.Office.Tools.Word.XMLNode 控制項的最後一個子節點。
	Level	取得 XMLNode 控制項的層級。
	NamespaceURI	取得 XMLNode 控制項的結構描述命名空間的統一資源識別元 (URI)。
	NextSibling	取得 Microsoft.Office.Interop.Word.XMLNode 物件，代表文件中下一個 Microsoft.Office.Tools.Word.XMLNode 物件與 Microsoft.Office.Interop.Word.XMLNode 的控制項是相同等級。
	NodeText	取得或設定 XMLNode 控制項的文字值。
	NodeType	取得表示 XMLNode 的種類，種類包含屬性與項目。
	NodeValue	取得或設定表示屬性的 XMLNode 值。
	OwnerDocument	取得 Microsoft.Office.Interop.Word.Document，這代表指定的 XMLNode 控制項的父文件。
	Parent	取得 Microsoft.Office.Interop.Word.Document，這表示包含指定的 XMLNode 控制項的文件。
	ParentNode	取得 Microsoft.Office.Interop.Word.XMLNode 物件，表示指定的 Microsoft.Office.Tools.Word.XMLNode 控制項的父項目。
	PlaceholderText	取得或設定未包含文字的 XMLNode 控制項所顯示的文字。
	PreviousSibling	取得 Microsoft.Office.Interop.Word.XMLNode 物件，代表文件中上一個 Microsoft.Office.Tools.Word.XMLNode 物件與 Microsoft.Office.Interop.Word.XMLNode 的控制項是相同等級。
	Range	取得 Range 物件，表示包含在 XMLNode 控制項內的文件的部分。
	Site	取得或設定與 IComponent 相關聯的 ISite。 (繼承自 IComponent)。
	SmartTag	取得 SmartTag 物件，表示與 XMLNode 控制項有關的智慧標籤。
	Tag	基礎架構。
	Text	取得或設定 XMLNode 控制項的未格式化的純文字。
	ValidationErrorText	取得表示在 XMLNode 控制項上的驗證錯誤描述的字串。
	ValidationStatus	取得值，該值可以根據附加的結構描述，指定項目或屬性是否有效。
	WordOpenXML	取得 XML 字串，表示採用 Microsoft Office Word Open XML 格式的 XMLNode。
	XML	取得在 XMLNode 控制項中表示 XML 文字的字串。

回頁首

方法

	名稱	說明
	BeginInit	表示物件正在啟動初始設定。 (繼承自 ISupportInitialize)。
	Copy	複製 XMLNode 控制項的內容至 [剪貼簿]。
	Cut	移除 XMLNode 控制項的內容，將內容放入 [剪貼簿]。
	Dispose	執行與釋放 (Free)、釋放 (Release) 或重設 Unmanaged 資源相關聯之應用程式定義的工作。 (繼承自 IDisposable)。
	EndInit	表示物件已完成初始設定。 (繼承自 ISupportInitialize)。
	get_ValidationErrorText	基礎架構。
	get_XML	基礎架構。
	Load	從指定的 XML 檔案更新 XMLNode 控制項資料。
	LoadXml(String)	從指定的 XML 字串的資料填入 XMLNode 控制項。
	LoadXml(XmlDocument)	用來自指定 XmlDocument 的根節點的資料填入 XMLNode 控制項。
	LoadXml(XmlElement)	從 XmlElement 的資料填入 XMLNode 控制項。
	RemoveChild	從 XMLNode 控制項中移除指定的子項目。
	SelectNodes	取得 Microsoft.Office.Interop.Word.XMLNodes 集合，表示符合 XPath 參數的節點，並且是 Microsoft.Office.Tools.Word.XMLNode 控制項中出現的排列順序。
	SelectSingleNode	取得 Microsoft.Office.Interop.Word.XMLNode 物件，代表第一個符合 Microsoft.Office.Tools.Word.XMLNode 控制項中 XPath 參數的子節點。
	SetValidationError	變更 XMLNode 控制項顯示給使用者的驗證錯誤文字，強制 Microsoft Office Word 將節點回報為無效。
	Validate	驗證個別的 XMLNode 控制項是否違反附加的 XML 結構描述或結構描述。

回頁首

事件

	名稱	說明
	AfterInsert	當使用者加入新的 XMLNode 控制項至文件中便會發生。
	BeforeDelete	當使用者從文件中刪除 XMLNode 控制項，在刪除掉該控制項之前便會發生。
	BindingContextChanged	在 ContentControlBase 的 BindingContext 屬性值變更時發生。
	ContextEnter	當游標從節點內容以外的區域，放到 XMLNode 或其中一個子代節點時發生。
	ContextLeave	當游標從 XMLNode 控制項 (即其中一個從屬節點) 移至原始節點的內容以外的區域時，便會發生。
	Deselect	當游標移出 XMLNode 控制項時便會發生。
	Disposed	表示處理元件的 Disposed 事件的方法。 (繼承自 IComponent)。
	Select	當游標置於 XMLNode 控制項內部時便會發生。
	ValidationError	當 XMLNode 控制項出現驗證錯誤時便會發生。

回頁首

備註

當您在設計階段將非重複結構描述項目對應到 Microsoft Office Word 文件時，Visual Studio 會為只能在文件中出現一次的每個項目建立一個 XMLNode 控制項。 非重複結構描述項目是一個具有 maxOccurs 屬性 (設定為 1) 的項目。

XMLNode 控制項只能在設計階段於 Word 文件層級專案中建立。 無法在執行階段或應用程式層級專案中建立它們。 如需詳細資訊，請參閱 XMLNode 控制項和HOW TO：將 XMLNode 控制項加入至 Word 文件。

注意事項
此介面是由 Visual Studio Tools for Office Runtime 所實作， 並不能實作於您的程式碼中。 如需詳細資訊，請參閱 Visual Studio Tools for Office Runtime 概觀。

使用方式

本文件說明此型別用於以 .NET Framework 4 為目標之 Office 專案的版本。在以 .NET Framework 3.5 為目標的專案中，此型別可能會有不同的成員，而為此型別提供的程式碼範例可能無法運作。 如需此型別在以 .NET Framework 3.5 為目標之專案中的相關文件，請參閱下列 Visual Studio 2008 文件中的參考章節：https://go.microsoft.com/fwlink/?LinkId=160658 (英文)。

請參閱

參考

Microsoft.Office.Tools.Word 命名空間

其他資源

XMLNode 控制項

HOW TO：將 XMLNode 控制項加入至 Word 文件