EventManager (Clase)

Se usa para inicializar y enlazar los controladores de eventos del método InternalStartup de una plantilla de formulario.

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

Sintaxis

'Declaración
Public MustInherit Class EventManager
'Uso
Dim instance As EventManager

public abstract class EventManager

Comentarios

InfoPath usa la clase EventManager para enlazar los controladores de eventos de todos los eventos implementados por las clases ControlEvents, FormEvents y XmlEvents del método InternalStartup del 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.

Nota

Al abrir una plantilla de formulario en InfoPath, se llama al método InternalStartup siempre que un usuario abre dicha plantilla. Por el contrario, si la plantilla de formulario se abre en un explorador web desde Microsoft Office Forms Server 2007 o desde una biblioteca de documentos configurada correctamente en Office SharePoint Server 2007 en que se esté ejecutando InfoPath Forms Services, se llama al método InternalStartup sólo la primera vez que se carga en un AppDomain del servidor el ensamblado de lógica empresarial de la plantilla de formulario. Normalmente, se trata de la ocasión en que el primer usuario abre una instancia de la plantilla de formulario durante una sesión, o tras reciclar el AppDomain durante una sesión.

Ejemplo

En los siguientes ejemplos, se muestra el método InternalStartup de una clase FormCode (procedente de los archivos FormCode.cs o FormCode.vb) de una plantilla de formulario que enlaza los controladores de eventos de un evento Loading de formulario, un evento Changed de campo, y un evento Clicked del control Botón mediante sus correspondientes delegados.

Importante

InfoPath genera el método InternalStartup y el código de enlace de eventos que contiene cuando se agregan controladores de eventos mediante diversos comandos de la interfaz de usuario al diseñar la plantilla de formulario. No debe crear el método InternalStartup ni escribir código adicional en él. Para obtener información sobre cómo añadir controladores de eventos mediante comandos de la interfaz de usuario, vea Cómo agregar un controlador de eventos.

public void InternalStartup()
{
   EventManager.FormEvents.Loading += 
      new LoadingEventHandler(FormEvents_Loading);
   EventManager.XmlEvents["/my:myFields/my:Name"].Changed += 
      new XmlChangedEventHandler(Name_Changed);
   ((ButtonEvent)EventManager.ControlEvents["MyBtn"]).Clicked += 
      new ClickedEventHandler(MyBtn_Clicked);
}

Private Sub InternalStartup(ByVal sender As Object, _
   ByVal e As EventArgs) Handles Me.Startup
   AddHandler EventManager.FormEvents.Loading, _
      AddressOf FormEvents_Loading
   AddHandler EventManager.XmlEvents("/my:myFields/my:Name").Changed, _
      AddressOf Name_Changed
   AddHandler DirectCast(EventManager.ControlEvents("MyBtn"), _
      ButtonEvent).Clicked, AddressOf MyBtn_Clicked
End Sub

Jerarquía de herencia

System.Object
  Microsoft.Office.InfoPath.EventManager

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

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