Gerando eventos no componente Script

Os eventos fornecem um modo de relatar erros, avisos e outras informações, como o progresso ou status da tarefa, ao pacote que os contém. O pacote fornece manipuladores de eventos para gerenciar notificações de eventos. O componente Script pode gerar eventos chamando métodos na propriedade ComponentMetaData da classe ScriptMain. Para obter mais informações sobre como pacotes do Integration Services lidam com eventos, consulte Manipuladores de eventos do SSIS (Integration Services).

Os eventos podem ser registrados em qualquer provedor de log que esteja habilitado no pacote. Provedores de logs armazenam informações sobre eventos em um repositório de dados. O componente Script também pode usar o método Log para registrar informações para um provedor de log sem gerar um evento. Para obter mais informações sobre como usar o método Log, consulte a seção seguinte.

Para gerar um evento, a tarefa Script chama um dos métodos seguintes da interface IDTSComponentMetaData100 expostos pela propriedade ComponentMetaData:

Evento	Descrição
FireCustomEvent	Gera um evento personalizado definido pelo usuário no pacote.
FireError	Informa o pacote sobre uma condição de erro.
FireInformation	Fornece informações ao usuário.
FireProgress	Informa o pacote sobre o progresso do componente.
FireWarning	Informa o pacote que o componente está em um estado que garante a notificação do usuário, mas não é uma condição de erro.

Eis um exemplo simples de geração de um evento de erro:

Dim myMetadata as IDTSComponentMetaData100

myMetaData = Me.ComponentMetaData

myMetaData.FireError(...)

Fique atualizado com o Integration Services Para obter os downloads, artigos, exemplos e vídeos mais recentes da Microsoft, assim como soluções selecionadas pela comunidade, visite a página do Integration Services no MSDN: Visite a página do Integration Services no MSDN Para receber uma notificação automática dessas atualizações, assine os RSS feeds disponíveis na página.

Consulte também

Tarefas

Adicionar um manipulador de eventos a um pacote

Conceitos

Manipuladores de eventos do SSIS (Integration Services)