Generazione di eventi nel componente scriptRaising Events in the Script Component

Gli eventi consentono di segnalare errori, avvisi e altre informazioni, ad esempio l'avanzamento o lo stato delle attività, al pacchetto contenitore.Events provide a way to report errors, warnings, and other information, such as task progress or status, to the containing package. Il pacchetto fornisce gestori eventi per la gestione di notifiche degli eventi.The package provides event handlers for managing event notifications. Il componente Script può generare eventi chiamando metodi sul ComponentMetaData proprietà del la classe ScriptMain classe.The Script component can raise events by calling methods on the ComponentMetaData property of the ScriptMain class. Per ulteriori informazioni su come Integration ServicesIntegration Services pacchetti gestione degli eventi, vedere Integration Services ( SSIS ) I gestori eventi.For more information about how Integration ServicesIntegration Services packages handle events, see Integration Services (SSIS) Event Handlers.

Gli eventi possono essere registrati in qualsiasi provider di log abilitato nel pacchetto.Events can be logged to any log provider that is enabled in the package. I provider di log archiviano informazioni sugli eventi in un archivio dati.Log providers store information about events in a data store. Il componente script può anche utilizzare il metodo Log per registrare informazioni in un provider di log senza generare un evento.The Script component can also use the Log method to log information to a log provider without raising an event. Per ulteriori informazioni sull'utilizzo del metodo Log, vedere la sezione seguente.For more information about how to use the Log method, see the following section.

Per generare un evento, l'attività Script chiama uno dei metodi seguenti dell'interfaccia IDTSComponentMetaData100 esposta dalla proprietà ComponentMetaData:To raise an event, the Script task calls one of the following methods of the IDTSComponentMetaData100 interface exposed by the ComponentMetaData property:

EventoEvent DescriptionDescription
FireCustomEvent Genera un evento personalizzato definito dall'utente nel pacchetto.Raises a user-defined custom event in the package.
FireError Informa il pacchetto di una condizione di errore.Informs the package of an error condition.
FireInformation Fornisce informazioni all'utente.Provides information to the user.
FireProgress Informa il pacchetto dello stato del componente.Informs the package of the progress of the component.
FireWarning Informa il pacchetto che il componente è in uno stato che garantisce la notifica all'utente, ma non è una condizione di errore.Informs the package that the component is in a state that warrants user notification, but is not an error condition.

Di seguito è riportato un semplice esempio di generazione di un evento Error:Here is a simple example of raising an Error event:

Dim myMetadata as IDTSComponentMetaData100

myMetaData = Me.ComponentMetaData

myMetaData.FireError(...)

Vedere ancheSee Also

Integration Services ( SSIS ) Gestori eventi Integration Services (SSIS) Event Handlers
Aggiungere un gestore eventi a un pacchettoAdd an Event Handler to a Package