(XPathNavigator) del método EmailSubmitConnection.Execute
Anula el método Execute predeterminado para permitir que se especifique otro origen de datos para su envío.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustOverride Sub Execute ( _
input As XPathNavigator _
)
'Uso
Dim instance As EmailSubmitConnection
Dim input As XPathNavigator
instance.Execute(input)
public abstract void Execute(
XPathNavigator input
)
Parámetros
input
Tipo: System.Xml.XPath.XPathNavigatorObjetoXPathNavigator situado en el nodo XML que contiene los datos a enviar.
Excepciones
Excepción | Condición |
---|---|
ArgumentNullException | El parámetro pasado a este método es una referencia null (Nothing en Visual Basic). |
ArgumentException | El parámetro que se ha pasado a este método no esválido. Por ejemplo, es de un tipo o formato no válidos. |
Comentarios
Este método anula el método Execute() predeterminado (heredado de la clase base DataConnection), que envía el origen de datos principal del formulario. El objeto XPathNavigator especificado para el parámetro input debe indicar un nodo XML que contenga los datos que se van a enviar. Dichos datos se pueden especificar mediante cualquier objeto DataSource.
Si se establece el parámetro input en null, el resultado es el mismo que si se usa el método Execute() predeterminado para enviar todo el formulario mediante la configuración declarativa definida en la plantilla de formulario.
Únicamente se puede acceder a este miembro con formularios que se ejecuten en el mismo dominio que el formulario que está actualmente abierto o con formularios a los que se hayan concedido permisos entre dominios.
Se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler o en un explorador web.
Ejemplos
En el ejemplo siguiente se usa el método Execute(XPathNavigator) para enviar el formulario a la conexión de datos denominada "Email Submit" mediante los datos del origen de datos denominado "QueryTypedDataSet" en lugar del origen de datos principal del formulario.
public void FormEvents_Submit(object sender, SubmitEventArgs e)
{
XmlForm myXmlForm = this;
XPathNavigator myNav = myXmlForm.DataSources[
"QueryTypedDataSet"].CreateNavigator();
EmailSubmitConnection mySubmit = (EmailSubmitConnection)myXmlForm.
DataConnections["Email Submit"];
mySubmit.Execute(myNav);
}
Public Sub FormEvents_Submit(ByVal sender As Object, _
ByVal e As SubmitEventArgs)
Dim myXmlForm As XmlForm = Me
Dim myNav As XPathNavigator = myXmlForm.DataSources(_
"QueryTypedDataSet").CreateNavigator()
EmailSubmitConnection mySubmit = DirectCast( _
myXmlForm.DataConnections("Email Submit"),EmailSubmitConnection)
mySubmit.Execute(myNav)
End Sub