IVsaCodeItem.AddEventSource (Método)
Agrega un origen de eventos al elemento de código. El elemento de código usa el origen de eventos para enlazar un evento al origen de eventos indicado; para ello, llama al método IVsaSite.GetEventSourceInstance implementado por el host.
Espacio de nombres: Microsoft.Vsa
Ensamblado: Microsoft.Vsa (en Microsoft.Vsa.dll)
Sintaxis
'Declaración
<PermissionSetAttribute(SecurityAction.LinkDemand, Name := "FullTrust")> _
Sub AddEventSource ( _
eventSourceName As String, _
eventSourceType As String _
)
[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
void AddEventSource(
string eventSourceName,
string eventSourceType
)
[PermissionSetAttribute(SecurityAction::LinkDemand, Name = L"FullTrust")]
void AddEventSource(
String^ eventSourceName,
String^ eventSourceType
)
[<PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")>]
abstract AddEventSource :
eventSourceName:string *
eventSourceType:string -> unit
function AddEventSource(
eventSourceName : String,
eventSourceType : String
)
Parámetros
eventSourceName
Tipo: StringNombre de programación del origen de eventos.
eventSourceType
Tipo: StringNombre de tipo del origen de eventos.
Comentarios
El motor de secuencia de comandos utiliza la información proporcionada por el método AddEventSource para enlazar eventos al origen de eventos con nombre. Obtiene los orígenes de eventos llamando al método IVsaSite.GetEventSourceInstance, implementado por el host. El método AddEventSource crea una clase que controla los eventos provocados por un objeto proporcionado por el host.
Nota
El motor de secuencias de comandos de JScript .NET no admite este método.Cuando el motor de JScript .NET deba enlazar un evento, debe hacerlo utilizando un elemento global.En lugar de orígenes de eventos, el motor de JScript .NET utiliza tipos de elemento AppGlobal.Para obtener más información, vea VsaItemType.
En el elemento de código, puede tener acceso el objeto de origen de eventos por nombre y, una vez que tiene acceso, puede escribir controladores de eventos para el objeto. El tipo de origen de eventos se pasa como una cadena en lugar de un objeto de tipo para facilitar la implementación de orígenes de eventos por hosts no administrados.
El compilador utiliza el parámetro eventSourceType para enlazar a los métodos proporcionados por el tipo. También se utiliza más adelante cuando el motor de secuencia de comandos llama al método IVsaSite.GetEventSourceInstance para solicitar una instancia del objeto de texto.
Para obtener más información acerca de los mecanismos para enlazar eventos para el motor de secuencias de comandos, vea el método IVsaSite.GetEventSourceInstance.