Clase EventManager
Se usa para inicializar y enlazar los controladores de eventos del método InternalStartup de una plantilla de formulario.
Jerarquía de la herencia
System.Object
Microsoft.Office.InfoPath.EventManager
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 una biblioteca de documentos configurada correctamente en SharePoint Server 2010 con InfoPath Forms Services, se llama al método InternalStartup únicamente 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.
Ejemplos
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 controladores 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
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.