IVsaCodeItem.AddEventSource(String, String) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Vsa

Zestaw:

Microsoft.Vsa.dll

Dodaje źródło zdarzeń do elementu kodu. Element kodu używa źródła zdarzeń, aby podłączyć zdarzenie do nazwanego źródła zdarzeń przez wywołanie metody IVsaSite.GetEventSourceInstance, która jest implementowana przez hosta.

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)

Parametry

eventSourceName

String

Programowa nazwa źródła zdarzeń.

eventSourceType

String

Nazwa typu źródła zdarzeń.

Uwagi

Aparat skryptów używa informacji dostarczonych przez metodę AddEventSource, aby podłączyć zdarzenia do nazwanego źródła zdarzeń. Uzyskuje źródła zdarzeń przez wywołanie metody IVsaSite.GetEventSourceInstance, która jest implementowana przez hosta. Metoda AddEventSource tworzy klasę, która obsługuje zdarzenia zgłaszane przez obiekt dostarczony przez hosta.

Uwaga

Aparat skryptów .NET w języku JScript nie obsługuje tej metody. W przypadkach, gdy aparat platformy .NET w języku JScript musi podłączyć zdarzenie, należy to zrobić przy użyciu elementu globalnego. Zamiast źródeł zdarzeń aparat platformy .NET w języku JScript używa typów elementów AppGlobal. Aby uzyskać więcej informacji, zobacz VsaItemType.

W elemencie kodu można uzyskać dostęp do obiektu źródła zdarzeń według nazwy, a po uzyskaniu do tego dostępu można zapisywać programy obsługi zdarzeń względem obiektu. Typ źródła zdarzeń jest przekazywany jako ciąg, a nie jako obiekt Typu, aby ułatwić implementowanie źródeł zdarzeń przez hosty niezarządzane.

Kompilator używa parametru eventSourceType do powiązania z metodami dostarczonymi przez typ. Jest on również używany później, gdy aparat skryptów wywołuje metodę IVsaSite.GetEventSourceInstance, aby zażądać wystąpienia obiektu Type.

Aby uzyskać więcej informacji na temat mechanizmów podłączania zdarzeń dla aparatu skryptów, zobacz metodę IVsaSite.GetEventSourceInstance.