Método IVsaCodeItem.AddEventSource

Artigo
05/17/2015

Adiciona uma fonte de evento para o item de código. O item de código usa a origem do evento para associar um evento com a fonte de evento nomeado chamando o método IVsaSite.GetEventSourceInstance, que é implementado pelo host.

Namespace: Microsoft.Vsa
Assembly: Microsoft.Vsa (em Microsoft.Vsa.dll)

Sintaxe

'Declaração
<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: String

Um nome programático de origem do evento.

eventSourceType
Tipo: String

O nome do tipo de origem do evento.

Comentários

O mecanismo de script usa as informações fornecidas pelo método AddEventSource para ligar eventos para a origem do evento nomeado. Obtém fontes de evento chamando o método IVsaSite.GetEventSourceInstance, que é implementado pelo host. O método AddEventSource cria uma classe que trata os eventos gerados por um objeto fornecido pelo host.

Dica

O mecanismo de script JScript .NET não oferece suporte a esse método.Em casos em que o mecanismo do JScript .NET deve associar um evento, você deve fazer isso usando um item global.Em vez de fontes de evento, o mecanismo do JScript .NET usa tipos de item AppGlobal.Para obter mais informações, consulte VsaItemType.

Dentro do item de código, você pode acessar o objeto de origem do evento por nome e, quando acessado, você pode escrever manipuladores de eventos com o objeto. O tipo de origem do evento é passado como uma cadeia de caracteres em vez de um objeto de tipo para facilitar a implementação de origens de eventos por hosts não gerenciados.

O compilador usa o parâmetro eventSourceType para associar a métodos fornecidos pelo tipo. Ele também é usado posteriormente quando o mecanismo de script chama o método IVsaSite.GetEventSourceInstance para solicitar uma instância do objeto de texto.

Para obter mais informações sobre os mecanismos de eventos para o mecanismo de script, consulte o método IVsaSite.GetEventSourceInstance.

Consulte também

Referência

IVsaCodeItem Interface

Namespace Microsoft.Vsa

Compartilhar via