XmlEvents 類別

表單範本所有 XmlEvent 事件的集合。

**命名空間：**Microsoft.Office.InfoPath
**組件：**Microsoft.Office.InfoPath (於 microsoft.office.infopath.dll 中)

語法

'宣告
<DefaultMemberAttribute("Item")> _
Public MustInherit Class XmlEvents
'用途
Dim instance As XmlEvents

[DefaultMemberAttribute("Item")] 
public abstract class XmlEvents

備註

XmlEvents 集合及 XmlEvent 類別是用於將文件層級事件 (例如，表單基礎 XML 文件中欄位或群組的 Changed 事件) 繫結至 InternalStartup 方法 (位於 Managed 程式碼表單範本中 FormCode 類別的開頭處) 中的事件處理常式。在執行階段期間，如果表單範本是以初始化所有事件處理常式之繫結的狀態開啟時，會執行 InternalStartup 方法。

重要

其中的 InternalStartup 方法與事件繫結程式碼，都是您在使用各種不同的使用者介面命令來新增事件處理常式時，由 InfoPath 所產生的。您自己不需要在其中建立 InternalStartup 方法或撰寫任何額外的程式碼。如需如何透過使用者介面命令新增事件處理常式的詳細資訊，請參閱操作方法：新增事件處理常式。

範例

下列範例示範 InfoPath 以 InternalStartup 方法所產生的程式碼，使用 XmlEvents 類別的 XmlEvents.Item(String) 屬性，繫結 Validating 事件 (與表單基礎 XML 文件中的欄位關聯) 的事件處理常式。該程式碼也會示範為欄位之 Changed 事件所產生的程式碼，其使用 XmlEvents 類別的 XmlEvents.Item(String,String) 屬性，將該欄位繫結至次要資料來源 (名為 Categories) 的 CategoryName 資料行。

public void InternalStartup()
{
   EventManager.XmlEvents["/my:myFields/my:field1"].Validating 
      += new XmlChangedEventHandler(field1_Validating);
   EventManager.XmlEvents[
      "/dfs:myFields/dfs:dataFields/d:Categories/@CategoryName", 
      "Categories"].Changed 
      += new XmlChangedEventHandler(
      Categories__CategoryName_attr_Changed);
}

Private Sub InternalStartup(ByVal sender As Object, _
   ByVal e As EventArgs) Handles Me.Startup
   AddHandler EventManager.XmlEvents( _
      "/my:myFields/my:field1").Validating, _
      AddressOf field2_Validating
   AddHandler EventManager.XmlEvents( _
      "/dfs:myFields/dfs:dataFields/d:Categories/@CategoryName", _
      "Categories").Changed, _
      AddressOf Categories__CategoryName_attr_Changed
End Sub

繼承階層

System.Object
  Microsoft.Office.InfoPath.XmlEvents

執行緒安全

此型別的所有公用靜態 (於 Visual Basic 共用) 成員都是執行緒安全。但並不保證所有執行個體成員為執行緒安全。

請參閱

參考

XmlEvents 成員
Microsoft.Office.InfoPath 命名空間