_XDocumentEventSink2_Event.OnMergeRequest Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se produce cuando se invoca la operación de combinación desde la interfaz de usuario de Microsoft InfoPath o desde la línea de comandos mediante la opción /aggregate .
public:
event Microsoft::Office::Interop::InfoPath::SemiTrust::_XDocumentEventSink2_OnMergeRequestEventHandler ^ OnMergeRequest;event Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnMergeRequestEventHandler OnMergeRequest;member this.OnMergeRequest : Microsoft.Office.Interop.InfoPath.SemiTrust._XDocumentEventSink2_OnMergeRequestEventHandler Event OnMergeRequest As _XDocumentEventSink2_OnMergeRequestEventHandler Tipo de evento
Ejemplos
En el ejemplo siguiente, el controlador del evento OnMergeRequest realiza una operación de combinación y establece variables para indicar el estado de dicha operación:
private bool _merging = false;
[InfoPathEventHandler(EventType=InfoPathEventType.<span class="label">OnMergeRequest</span>)]
public void OnMergeRequest(MergeEvent e)
{
// Set global property to indicate that forms are being merged.
if (e.Index == 0)
{
_merging = true;
}
thisXDocument.ImportDOM(e.DOM);
e.ReturnStatus = true;
if ((e.Index + 1) == e.Count)
{
_merging = false;
thisXDocument.UI.Alert("Your request to merge " + e.Count + " files is now complete.");
}
}
En el ejemplo siguiente, el controlador del evento OnMergeRequest realiza una operación de combinación y establece variables para indicar el estado de dicha operación:
private bool _merging = false;
[InfoPathEventHandler(EventType=InfoPathEventType.<span class="label">OnMergeRequest</span>)]
public void OnMergeRequest(MergeEvent e)
{
// Set global property to indicate that forms are being merged.
if (e.Index == 0)
{
_merging = true;
}
thisXDocument.ImportDOM(e.DOM);
e.ReturnStatus = true;
if ((e.Index + 1) == e.Count)
{
_merging = false;
thisXDocument.UI.Alert("Your request to merge " + e.Count + " files is now complete.");
}
}
Comentarios
Si la ReturnStatus propiedad del MergeEventObject objeto se establece en false, InfoPath cancela la operación de combinación. Si se produce un error en el código del evento OnMergeRequest , InfoPath omite el error y se basa en la propiedad ReturnStatus Si la propiedad ReturnStatus no está establecida explícitamente, se usa el valor predeterminado de false .
En el caso de formularios InfoPath almacenados en una biblioteca de formularios de Windows SharePoint Services, el evento OnMergeRequest también se produce cuando se ejecuta el método MergeDocuments2 del control OpenXMLDocuments. Para obtener más información sobre el control OpenXMLDocuments, vea el Kit de desarrollo de software de Microsoft SharePoint Products and Technologies 2003.
Nota: No hay ninguna interfaz de usuario (UI) en la ventana de diseño del formulario de InfoPath para crear este controlador de eventos. Para agregar este controlador de eventos al proyecto, incluya el atributo InfoPathEventHandler tal como aparece en el ejemplo.