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 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 armazenamento 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) Fique atualizado com o Integration Services

Para obter os mais recentes downloads, artigos, exemplos e vídeos da Microsoft, bem como soluções selecionadas da comunidade, visite a página do Integration Services no MSDN ou TechNet:

Para receber uma notificação automática das atualizações, assine os feeds RSS disponíveis na página.