Clase XmlEvents
Colección de todos los eventos XmlEvent para una plantilla de formulario.
Jerarquía de la herencia
System.Object
Microsoft.Office.InfoPath.XmlEvents
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustInherit Class XmlEvents
'Uso
Dim instance As XmlEvents
public abstract class XmlEvents
Comentarios
La colección XmlEvents y la clase XmlEvent se usan para enlazar un evento de documento (por ejemplo, el evento Changed de un campo o grupo de un documento XML subyacente de un formulario) a un controlador de eventos del método InternalStartup al principio de la clase FormCode de una plantilla de formulario de código administrado. En tiempo de ejecución, el método InternalStartup se ejecuta cuando la plantilla de formulario se abre para inicializar el enlace de todos los controladores de eventos.
Importante
El método InternalStartup y el código de enlace de eventos que contiene los genera InfoPath al agregar controladores de eventos mediante diversos comandos de la interfaz de usuario. No debe crear el método InternalStartup ni escribir código adicional en él. Para obtener más información sobre cómo agregar controladores de eventos mediante comandos de la interfaz, vea Cómo agregar un controlador de eventos.
Ejemplos
En el ejemplo siguiente, se muestra el código generado por InfoPath en el método InternalStartup para enlazar el controlador de eventos de un evento Validating asociado a un campo en el documento XML subyacente del formulario mediante la propiedad XmlEvents.Item[String] de la clase XmlEvents. También se muestra el código generado para el evento Changed de un campo enlazado a la columna CategoryName de un origen de datos secundario denominado Categories con la propiedad XmlEvents.Item[String, String] de la clase XmlEvents.
public void InternalStartup()
{
EventManager.XmlEvents["/my:myFields/my:field1"].Validating
+= new XmlChangedEventHandler(field1_Validating);
EventManager.XmlEvents[
"/dfs:myFields/dfs:dataFields/d:Categories/@CategoryName",
"Categories"].Changed
+= new XmlChangedEventHandler(
Categories__CategoryName_attr_Changed);
}
Private Sub InternalStartup(ByVal sender As Object, _
ByVal e As EventArgs) Handles Me.Startup
AddHandler EventManager.XmlEvents( _
"/my:myFields/my:field1").Validating, _
AddressOf field2_Validating
AddHandler EventManager.XmlEvents( _
"/dfs:myFields/dfs:dataFields/d:Categories/@CategoryName", _
"Categories").Changed, _
AddressOf Categories__CategoryName_attr_Changed
End Sub
Seguridad para subprocesos
Los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para los subprocesos.