Classe EventManager

Articolo
04/27/2010

Consente di inizializzare e associare i gestori eventi nel metodo InternalStartup di un modello di modulo.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

Public MustInherit Class EventManager

Dim instance As EventManager

public abstract class EventManager

Osservazioni

La classe EventManager viene utilizza da InfoPath per l'associazione di gestori eventi per tutti gli eventi implementati dalle classi ControlEvents, FormEvents e XmlEvents nel metodo InternalStartup all'inizio della classe FormCode in un modello di modulo in codice gestito. In fase di esecuzione, il metodo InternalStartup viene eseguito quando il modello di modulo viene aperto per inizializzare l'associazione di tutti i gestori eventi.

Nota:
Quando un modello di modulo viene aperto in InfoPath, il metodo InternalStartup viene aperto ogni volta che un utente apre il modello di modulo. Quando invece un modello di modulo viene aperto in un browser da Microsoft Office Forms Server 2007 o da una raccolta documenti correttamente configurata in un sistema Office SharePoint Server 2007 in cui è in esecuzione InfoPath Forms Services, il metodo InternalStartup viene chiamato solo la prima volta che l'assembly della regola business del modello di modulo viene caricato in un dominio applicazione (AppDomain) nel server. In genere, ciò avviene quando il primo utente apre un'istanza del modello di modulo durante una sessione oppure dopo che il dominio applicazione viene riciclato durante una sessione.

Quando un modello di modulo viene aperto in InfoPath, il metodo InternalStartup viene aperto ogni volta che un utente apre il modello di modulo. Quando invece un modello di modulo viene aperto in un browser da Microsoft Office Forms Server 2007 o da una raccolta documenti correttamente configurata in un sistema Office SharePoint Server 2007 in cui è in esecuzione InfoPath Forms Services, il metodo InternalStartup viene chiamato solo la prima volta che l'assembly della regola business del modello di modulo viene caricato in un dominio applicazione (AppDomain) nel server. In genere, ciò avviene quando il primo utente apre un'istanza del modello di modulo durante una sessione oppure dopo che il dominio applicazione viene riciclato durante una sessione.

Esempio

Negli esempi seguenti viene illustrato il metodo InternalStartup di una classe FormCode (del file FormCode.cs o FormCode.vb) di un modello di modulo che associa i gestori eventi per l'evento Loading di un modulo, l'evento Changed di un campo e l'evento Clicked di un controllo Pulsante utilizzando i delegati corrispondenti.

Importante:
Il metodo InternalStartup e il codice di associazione degli eventi interno a esso vengono generati da InfoPath quando si aggiungono gestori eventi utilizzando diversi comandi dell'interfaccia utente. Evitare di creare il metodo InternalStartup o di scrivere codice aggiuntivo interno al metodo manualmente. Per informazioni su come aggiungere gestori eventi utilizzando i comandi dell'interfaccia utente, vedere Procedura: Aggiungere un gestore eventi.

Il metodo InternalStartup e il codice di associazione degli eventi interno a esso vengono generati da InfoPath quando si aggiungono gestori eventi utilizzando diversi comandi dell'interfaccia utente. Evitare di creare il metodo InternalStartup o di scrivere codice aggiuntivo interno al metodo manualmente. Per informazioni su come aggiungere gestori eventi utilizzando i comandi dell'interfaccia utente, vedere Procedura: Aggiungere un gestore eventi.

public void InternalStartup()
{
   EventManager.FormEvents.Loading += 
      new LoadingEventHandler(FormEvents_Loading);
   EventManager.XmlEvents["/my:myFields/my:Name"].Changed += 
      new XmlChangedEventHandler(Name_Changed);
   ((ButtonEvent)EventManager.ControlEvents["MyBtn"]).Clicked += 
      new ClickedEventHandler(MyBtn_Clicked);
}

Private Sub InternalStartup(ByVal sender As Object, _
   ByVal e As EventArgs) Handles Me.Startup
   AddHandler EventManager.FormEvents.Loading, _
      AddressOf FormEvents_Loading
   AddHandler EventManager.XmlEvents("/my:myFields/my:Name").Changed, _
      AddressOf Name_Changed
   AddHandler DirectCast(EventManager.ControlEvents("MyBtn"), _
      ButtonEvent).Clicked, AddressOf MyBtn_Clicked
End Sub

Gerarchia di ereditarietà

System.Object
Microsoft.Office.InfoPath.EventManager

Thread Safety

Tutti i membri statici pubblici (Shared in Visual Basic) di questo tipo sono thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Membri EventManager
Spazio dei nomi Microsoft.Office.InfoPath

Condividi tramite