SubmitToHostConnection (Clase)

Representa una conexión para el envío de datos a un entorno de host.

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

Sintaxis

'Declaración
Public MustInherit Class SubmitToHostConnection
    Inherits DataConnection
'Uso
Dim instance As SubmitToHostConnection

public abstract class SubmitToHostConnection : DataConnection

Comentarios

Este tipo de conexión se usa en una plantilla de formulario abierta por una aplicación que aloja el entorno de edición de formularios de InfoPath como control. Para obtener información sobre cómo alojar InfoPath en otra aplicación, incluida la información para crear un método que controle el evento de envío de un formulario en el código de la aplicación host, vea el artículo titulado "Hosting the InfoPath Form Editing Environment in a Custom WinForm Application" en InfoPath Developer Portal (en inglés) en MSDN.

Para crear una conexión de datos para enviar datos a un entorno de host al que se puede hacer referencia desde la lógica empresarial de una plantilla de formulario, use el comando Conexiones de datos del menú Herramientas. Para obtener información sobre cómo crear un controlador de eventos que se ejecute cuando se provoque el evento Submit, vea Cómo agregar un controlador de eventos.

Ejemplo

En el siguiente ejemplo se muestra un patrón para escribir código que realizará acciones personalizadas en la lógica empresarial de una plantilla de formulario antes de enviar el formulario.

public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
   // Get the data connection defined in the form template from the 
   // DataConnections collection and cast to the SubmitToHostConnection
   // type.
   SubmitToHostConnection submitConnection = 
      (SubmitToHostConnection)(DataConnections["MyHostConnection"]);

   // Write code here to do custom actions that are not 
   // supported by rules or other declarative settings.  

   // Execute the submit operation against the connection.
   submitConnection.Execute();

}

Public Sub FormEvents_Submit(ByVal sender As Object, _
   ByVal e As SubmitEventArg)
   ' Get the data connection defined in the form template from the
   ' DataConnections collection and cast to the SubmitToHostConnection
   ' type.
   Dim submitConnection As SubmitToHostConnection = _
      DirectCast(DataConnections("MyHostConnection"), _
      SubmitToHostConnection)

   ' Write code here to do custom actions that are not 
   ' supported by rules or other declarative settings.

   ' Execute the submit operation against the connection.
   submitConnection.Execute()
End Sub

Jerarquía de herencia

System.Object
   Microsoft.Office.InfoPath.DataConnection
    Microsoft.Office.InfoPath.SubmitToHostConnection

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

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