Partilhar via


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 os pacotes do Integration Services manipulam eventos, confira 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(...)

Ícone do Integration Services (pequeno) Mantenha-se atualizado com o Integration Services
Para obter os downloads, artigos, exemplos e vídeos mais recentes da Microsoft, bem como soluções selecionadas da 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.

Confira também

Manipuladores de eventos do SSIS (Integration Services)
Adicionar um manipulador de eventos a um pacote