SubmitToHostConnection Clase
Representa una conexión para el envío de datos a un entorno de hospedaje.
Jerarquía de herencia
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.SubmitToHostConnection
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 hospeda el entorno de edición de formularios de InfoPath como control. Para obtener información sobre cómo hospedar 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 de hospedaje, vea el artículo titulado "Hosting the InfoPath Form Editing Environment in a Custom WinForm Application" en InfoPath Developer Portal en MSDN.
Para crear una conexión de datos para enviar datos a un entorno de hospedaje al que se puede hacer referencia desde la lógica empresarial de una plantilla de formulario, use el comando Conexiones de datos de la pestaña Datos de la cinta. 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.
Ejemplos
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
Seguridad para subprocesos
Cualquier miembro static (Shared en Visual Basic) público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.