Agregar un controlador de eventos

En este tema se describen los procedimientos para agregar controladores de eventos a una plantilla de formulario de código administrado de Microsoft InfoPath mediante Visual Studio 2012. Para agregar un controlador de eventos a una plantilla de formulario, empiece con la plantilla de formulario abierta en el Diseñador de InfoPath y, a continuación, seleccione el comando de interfaz de usuario adecuado para el evento para el que desea escribir código. Después de seleccionar el comando de un evento en el Diseñador de InfoPath, el foco cambia automáticamente al controlador de eventos esqueleto para ese evento en el editor de código de Visual Studio 2012.

Importante

Siempre debe usar la interfaz de usuario del Diseñador de InfoPath para agregar un controlador de eventos. Al agregar un controlador de eventos con la interfaz de usuario, se genera un código de enlace de eventos en el método InternalStartup del archivo FormCode.cs o FormCode.vb en el proyecto de plantilla de formulario. No cree el método InternalStartup ni le agregue código adicional.

Agregar un controlador de eventos para el evento Click de un control Button

  1. Abra la plantilla de formulario en infoPath Designer y, a continuación, agregue un control Button al formulario.

  2. Haga clic en el botón y, a continuación, en la ficha Propiedades de la cinta, haga clic en Código personalizado.

    El foco se desplazará al esqueleto del controlador de eventos del evento Clicked en el editor de código de Visual Studio 2012.

Agregar un controlador de eventos para el evento Changing, Validating o Changed de un campo o un grupo

  1. Abra la plantilla de formulario en infoPath Designer.

  2. Haga clic con el botón secundario en un control de entrada de datos enlazado al campo o grupo, como un control de Cuadro de texto.

  3. Elija Programación y haga clic en el evento para el que desea crear un controlador de eventos. El foco se desplazará al esqueleto del controlador de eventos del evento Changing , Validating o Changed en el editor de código de Visual Studio 2012.

    Nota

    [!NOTA] El comando para crear un controlador de eventos para el evento Changing no está disponible si la configuración de compatibilidad de la plantilla de formulario está establecida en Formulario de explorador web. Esto se debe a que el evento Changing no es compatible con la lógica empresarial de las plantillas de formulario que se publican en las bibliotecas de documentos de Microsoft SharePoint Server 2010 con InfoPath Forms Services. Para crear un controlador de eventos para el evento Changing, debe cambiar la configuración de compatibilidad a InfoPath Editor en InfoPath Designer. Para esto, haga clic en la pestaña Archivo, haga clic en Opciones de formulario, haga clic en Compatibilidad y establezca Tipo de formulario en Formulario de InfoPath Editor.

Agregar un controlador de eventos para los eventos Loading, ViewSwitched, ContextChanged y Sign de un formulario

  1. Abra la plantilla de formulario en infoPath Designer.

  2. En la ficha Programador de la cinta, haga clic en el evento de formulario para el que desee escribir un controlador de eventos.

    El foco cambia al controlador de eventos esqueleto para el evento Loading, ViewSwitched, ContextChanged o Sign en el editor de código de Visual Studio 2012.

    Nota

    [!NOTA] Los comandos para crear un controlador de eventos para los eventos ContextChanged o Sign no están disponibles si la configuración de compatibilidad de la plantilla de formulario está establecida en Formulario de explorador web. Esto se debe a que tales eventos no se admiten en la lógica empresarial de las plantillas de formulario que se publican en bibliotecas de documentos de Microsoft SharePoint Server 2010 con InfoPath Forms Services. Para crear un controlador de eventos para el evento ContextChanged o Sign , debe cambiar la configuración de compatibilidad a Formulario del editor de InfoPath en el Diseñador de InfoPath. Para esto, haga clic en la pestaña Archivo, haga clic en Opciones de formulario, haga clic en Compatibilidad y establezca Tipo de formulario en Formulario de InfoPath Editor.

Agregar un controlador de eventos para el evento Submit de un formulario

  1. Abra la plantilla de formulario en infoPath Designer.

  2. Haga clic en la pestaña Archivo, haga clic en Enviar a en la pestaña Información y, a continuación, haga clic en Opciones de envío.

  3. Haga clic en Permitir a los usuarios enviar este formulario, a continuación en Realizar una acción personalizada utilizando código y, por último, haga clic en Modificar código.

    Se desplazará el foco al esqueleto del controlador de eventos del evento Submit en el editor de código de Visual Studio 2012.

Agregar un controlador de eventos para el evento Save de un formulario

  1. Abra la plantilla de formulario en infoPath Designer.

  2. Haga clic en la pestaña Archivo y a continuación haga clic en Opciones de formulario en la ficha Información.

  3. Haga clic en la categoría Guardar, active la casilla de verificación Guardar usando código personalizado y después haga clic en Editar.

    Se desplazará el foco al esqueleto del controlador de eventos del evento Save en el editor de código de Visual Studio 2012.

    Nota

    [!NOTA] La casilla de verificación Guardar usando código personalizado no está disponible si la configuración de compatibilidad de la plantilla de formulario es InfoPath Forms Services. Esto se debe a que el evento Save no se admite en la lógica empresarial de las plantillas de formulario publicadas en las bibliotecas de documentos de Microsoft SharePoint Server 2010 con InfoPath Forms Services. Para crear un controlador de eventos para el evento Save , debe cambiar la configuración de compatibilidad a Formulario de editor de InfoPath en el Diseñador de InfoPath. Para esto, haga clic en la pestaña Archivo, haga clic en Opciones de formulario, haga clic en Compatibilidad y establezca Tipo de formulario en Formulario de InfoPath Editor.

Agregar un controlador de eventos para el evento VersionUpgrade de un formulario

  1. Abra la plantilla de formulario en infoPath Designer.

  2. Haga clic en la pestaña Archivo y a continuación haga clic en Opciones de formulario en la ficha Información.

  3. Haga clic en la categoría Control de versiones, seleccione Utilizar evento personalizado en el cuadro de lista desplegable Actualizar formularios existentes y haga clic en Editar.

    Se desplazará el foco al esqueleto del controlador de eventos del evento Save en el editor de código de Visual Studio 2012.

Agregar un controlador de eventos para el evento Merge de un formulario

  1. Abra la plantilla de formulario en infoPath Designer.

  2. Haga clic en la pestaña Archivo y a continuación haga clic en Opciones de formulario en la ficha Información.

  3. En la categoría Avanzadas, haga clic en la casilla de verificación Habilitar la combinación de formularios, active la casilla de verificación Combinar usando código personalizado y haga clic en Editar.

    Se desplazará el foco al esqueleto del controlador de eventos del evento Merge en el editor de código de Visual Studio 2012.

    Nota

    [!NOTA] La casilla de verificación Habilitar la combinación de formularios no está disponible si la configuración de compatibilidad de la plantilla de formulario está establecida en InfoPath Forms Services. Esto se debe a que el evento Merge no se admite en la lógica empresarial de las plantillas de formulario publicadas en las bibliotecas de documentos de Microsoft SharePoint Server 2010 con InfoPath Forms Services. Para crear un controlador de eventos para el evento Merge , debe cambiar la configuración de compatibilidad a InfoPath Editor Form en infoPath Designer. Para esto, haga clic en la pestaña Archivo, haga clic en Opciones de formulario, haga clic en Compatibilidad y establezca Tipo de formulario en Formulario de InfoPath Editor.

Consulte también

Tutorial: Crear una plantilla de formulario básica con código