IVsaCodeItem.AddEventSource(String, String) Methode

Definition

Namespace:

Microsoft.Vsa

Assembly:

Microsoft.Vsa.dll

Fügt dem Codeelement eine Ereignisquelle hinzu. Das Codeelement verwendet die Ereignisquelle, um ein Ereignis mit der benannten Ereignisquelle zu verknüpfen, indem es die vom Host implementierte IVsaSite.GetEventSourceInstance-Methode aufruft.

public:
 void AddEventSource(System::String ^ eventSourceName, System::String ^ eventSourceType);

public void AddEventSource (string eventSourceName, string eventSourceType);

abstract member AddEventSource : string * string -> unit

Public Sub AddEventSource (eventSourceName As String, eventSourceType As String)

Parameter

eventSourceName

String

Ein programmgesteuerter Name der Ereignisquelle.

eventSourceType

String

Der Typname der Ereignisquelle.

Hinweise

Die Skript-Engine verwendet Informationen, die von der AddEventSource-Methode bereitgestellt werden, um Ereignisse mit der benannten Ereignisquelle zu verbinden. Ereignisquellen werden durch Aufrufen der IVsaSite.GetEventSourceInstance-Methode abgerufen, die vom Host implementiert wird. Die AddEventSource-Methode erstellt eine Klasse, die Ereignisse verarbeitet, die von einem vom Host bereitgestellten Objekt ausgelöst werden.

Hinweis

Die JScript .NET-Skript-Engine unterstützt diese Methode nicht. In Fällen, in denen die JScript .NET-Engine ein Ereignis einbinden muss, müssen Sie dazu ein globales Element verwenden. Anstelle von Ereignisquellen verwendet die JScript .NET-Engine AppGlobal-Elementtypen. Weitere Informationen finden Sie unter VsaItemType.

Innerhalb des Codeelements können Sie anhand des Namens auf das Ereignisquellobjekt zugreifen, und nach dem Zugriff können Sie Ereignishandler für das -Objekt schreiben. Der Ereignisquellentyp wird als Zeichenfolge und nicht als Type-Objekt übergeben, um die Implementierung von Ereignisquellen durch nicht verwaltete Hosts zu vereinfachen.

Der Compiler verwendet den eventSourceType-Parameter, um eine Bindung an vom Typ bereitgestellte Methoden zu erstellen. Sie wird auch später verwendet, wenn die Skript-Engine die IVsaSite.GetEventSourceInstance-Methode aufruft, um eine instance des Type-Objekts anzufordern.

Weitere Informationen zu den Mechanismen zum Einbinden von Ereignissen für die Skript-Engine finden Sie unter der IVsaSite.GetEventSourceInstance-Methode.