Auslösen von Ereignissen in der Skriptkomponente
Ereignisse bieten eine Möglichkeit, Fehler, Warnungen und andere Informationen, wie z. B. den Fortschritt oder Status eines Tasks, an das entsprechende Paket zu melden. Das Paket stellt Ereignishandler zum Verwalten von Ereignisbenachrichtigungen bereit. Die Skriptkomponente kann Ereignisse durch Aufrufen der Methoden in der ComponentMetaData-Eigenschaft der ScriptMain-Klasse auslösen. Weitere Informationen dazu, wie Integration Services-Pakete Ereignisse behandeln, finden Sie unter Ereignishandler von SQL Server Integration Services.
Ereignisse können in jedem Protokollanbieter protokolliert werden, der im Paket aktiviert wird. Protokollanbieter speichern Informationen über Ereignisse in einem Datenspeicher. Die Skriptkomponente kann ebenfalls die Log-Methode verwenden, um Informationen in einem Protokollanbieter zu protokollieren, ohne ein Ereignis auszulösen. Weitere Informationen zur Verwendung der Log-Methode finden Sie im folgenden Abschnitt.
Um ein Ereignis auszulösen, ruft der Skripttask eine der folgenden Methoden der IDTSComponentMetaData100-Schnittstelle auf, die von der ComponentMetaData-Eigenschaft verfügbar gemacht wird:
Ereignis |
Beschreibung |
---|---|
Löst ein benutzerdefiniertes Ereignis im Paket aus. |
|
Informiert das Paket über eine Fehlerbedingung. |
|
Stellt Informationen für den Benutzer bereit. |
|
Informiert das Paket über den Fortschritt der Komponente. |
|
Informiert das Paket darüber, dass die Komponente einen Status aufweist, der eine Benutzerbenachrichtigung erfordert, bei dem es sich aber nicht um eine Fehlerbedingung handelt. |
Nachfolgend finden Sie ein einfaches Beispiel zur Auslösung eines Error-Ereignisses:
Dim myMetadata as IDTSComponentMetaData100
myMetaData = Me.ComponentMetaData
myMetaData.FireError(...)
|
Siehe auch