(ActionType, String) del método View.ExecuteAction
Ejecuta un comando de edición en el documento XML subyacente de un formulario, en función del campo o grupo especificados.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustOverride Sub ExecuteAction ( _
action As ActionType, _
xmlToEdit As String _
)
'Uso
Dim instance As View
Dim action As ActionType
Dim xmlToEdit As String
instance.ExecuteAction(action, xmlToEdit)
public abstract void ExecuteAction(
ActionType action,
string xmlToEdit
)
Parámetros
action
Tipo: Microsoft.Office.InfoPath.ActionTypeEnumeración ActionType que especifica la acción que se debe llevar a cabo.
xmlToEdit
Tipo: System.StringEl identificador de XmlToEdit del campo o grupo al que se aplica la acción de edición.
Para determinar el identificador de XmlToEdit de un campo o grupo, haga el control al que está enlazado el campo o grupo, haga clic en Propiedades de tipo de Control de < > y, a continuación, haga clic en la ficha Opciones avanzadas. El valor de XmlToEdit se muestra en la sección código de la ficha.
Excepciones
Excepción | Condición |
---|---|
InvalidOperationException | Se ha llamado al método ExecuteAction desde un controlador de eventos para el evento Loading. |
ArgumentNullException | Los parámetros pasados a este método son una referencia null (Nothing en Visual Basic). |
ArgumentException | Los parámetros que se han pasado a este método no son válidos. Por ejemplo, son de un tipo o formato no válido. |
Comentarios
El método ExecuteAction se utiliza para realizar acciones de edición de programación integradas en el documento XML subyacente del formulario, de acuerdo con el contexto seleccionado en una vista.
La acción que se ejecuta será la misma que se utilizaría al hacer clic en el botón de menú o barra de herramientas equivalente; es decir, una acción para la que el elemento de botón del archivo .xsf tenga un los atributos xmlToEdit y action correspondientes. Al igual que cuando se utiliza un botón, la acción se basará en la selección actual: se aplicará al contexto seleccionado (y, en caso de que la selección suponga que el botón está deshabilitado, el método ExecuteAction no tendrá efecto alguno).
Puede determinar el identificador de XmlToEdit para un control o un grupo en un formulario de InfoPath en el Diseñador de mostrar el cuadro de diálogo de Propiedades del control y, a continuación, haga clic en la ficha Opciones avanzadas.
Nota
En determinados casos, al llamar al método ExecuteAction desde un controlador de eventos para el evento Clicked de un botón de la vista puede producir un error. Esto se debe a que el contexto seleccionado cambia al botón cuando se hace clic en él. En ese caso, es preferible utilizar un botón o vínculo de un panel de tareas personalizado, un menú o una barra de tareas para llamar al método ExecuteAction.
Ú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.
Únicamente se puede acceder a este tipo o miembro desde el código que se ejecuta en los formularios abiertos en Microsoft InfoPath Filler.
Ejemplos
En el ejemplo siguiente, se usa el método ExecuteAction(action, xmlToEdit) de la clase View para insertar datos en el grupo especificado mediante la acción ActionType.XCollectionInsert.
this.CurrentView.ExecuteAction(ActionType.XCollectionInsert,
"group1_1");
Me.CurrentView.ExecuteAction(ActionType.XCollectionInsert, "group1_1")