EventManager-Klasse
Wird zum Initialisieren und Binden von Ereignishandlern in der InternalStartup-Methode einer Formularvorlage verwendet.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.EventManager
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class EventManager
'Usage
Dim instance As EventManager
public abstract class EventManager
Hinweise
Die EventManager-Klasse wird von InfoPath verwendet, um Ereignishandler für alle Ereignisse zu binden, die durch die Klassen ControlEvents, FormEvents und XmlEvents in der InternalStartup-Methode am Anfang der FormCode-Klasse in einer verwalteten Codeformularvorlage implementiert werden. Zur Laufzeit wird die InternalStartup-Methode ausgeführt, wenn die Formularvorlage zum Initialisieren der Bindung aller Ereignishandler geöffnet wird.
Hinweis
Wenn eine Formularvorlage in InfoPath geöffnet wird, wird die InternalStartup-Methode jedes Mal aufgerufen, wenn ein Benutzer die Formularvorlage öffnet. Wenn eine Formularvorlage jedoch in einem Webbrowser aus einer entsprechend konfigurierten Dokumentbibliothek in SharePoint Server 2010 mit InfoPath Forms Services ausgeführt wird, wird die InternalStartup-Methode nur aufgerufen, wenn die Geschäftslogikassembly der Formularvorlage zum ersten Mal in ein AppDomain-Objekt auf dem Server geladen wird. Dies stimmt in der Regel mit der Zeit überein, zu der der erste Benutzer eine Instanz der Formularvorlage während einer Sitzung öffnet oder nach dem AppDomain-Recycling während einer Sitzung.
Beispiele
In den folgenden Beispielen wird die InternalStartup-Methode aus einer FormCode-Klasse (aus den Dateien "FormCode.cs" oder "FormCode.vb") einer Formularvorlage dargestellt, die die Ereignishandler für das Loading-Ereignis eines Formulars, das Changed-Ereignis eines Felds und ein Clicked-Ereignis des Steuerelements Schaltfläche mithilfe der entsprechenden Delegaten bindet.
Wichtig
Die InternalStartup-Methode und der Ereignisbindungscode darin werden von InfoPath generiert, wenn Sie Ereignishandler mithilfe verschiedener Benutzeroberflächenbefehle hinzufügen. Sie dürfen die InternalStartup-Methode nicht selbst erstellen oder zusätzlichen Code hinzufügen. Informationen zum Hinzufügen von Ereignishandlern mithilfe von Benutzeroberflächenbefehlen finden Sie unter Vorgehensweise: Hinzufügen eines Ereignishandlers.
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
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.