XmlEvents (Clase)

Colección de todos los eventos XmlEvent para una plantilla de formulario.

Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en microsoft.office.infopath.dll)

Sintaxis

<DefaultMemberAttribute("Item")> _
Public MustInherit Class XmlEvents

Dim instance As XmlEvents

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

Comentarios

La colección XmlEvents y la clase XmlEvent se usan para enlazar un evento de documento (por ejemplo, el evento Changed de un campo o grupo de un documento XML subyacente de un formulario) a un controlador de eventos del método InternalStartup al principio de la clase FormCode de una plantilla de formulario de código administrado. En tiempo de ejecución, el método InternalStartup se ejecuta cuando la plantilla de formulario se abre para inicializar el enlace de todos los controladores de eventos.

Importante:

El método InternalStartup y el código de enlace de eventos que contiene los genera InfoPath al agregar controladores de eventos mediante diversos comandos de la interfaz de usuario. No debe crear el método InternalStartup ni escribir código adicional en él. Para obtener más información sobre cómo agregar controladores de eventos mediante comandos de la interfaz, vea Cómo agregar un controlador de eventos.

Ejemplo

En el ejemplo siguiente, se muestra el código generado por InfoPath en el método InternalStartup para enlazar el controlador de eventos de un evento Validating asociado a un campo en el documento XML subyacente del formulario mediante la propiedad XmlEvents.Item(String) de la clase XmlEvents. También se muestra el código generado para el evento Changed de un campo enlazado a la columna CategoryName de un origen de datos secundario denominado Categories con la propiedad XmlEvents.Item(String,String) de la clase XmlEvents.

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

Jerarquía de herencia

System.Object
  Microsoft.Office.InfoPath.XmlEvents

Seguridad de subprocesos

Todos los miembros estáticos públicos (compartidos en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para los subprocesos.

Vea también

Referencia

XmlEvents (Miembros)
Microsoft.Office.InfoPath (Espacio de nombres)