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 Integration Services-Ereignishandler (SSIS).

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
FireCustomEvent	Löst ein benutzerdefiniertes Ereignis im Paket aus.
FireError	Informiert das Paket über eine Fehlerbedingung.
FireInformation	Stellt Informationen für den Benutzer bereit.
FireProgress	Informiert das Paket über den Fortschritt der Komponente.
FireWarning	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(...)

Bleiben Sie mit Integration Services auf dem neuesten Stand Die neuesten Downloads, Artikel, Beispiele und Videos von Microsoft sowie ausgewählte Lösungen aus der Community finden Sie auf MSDN auf der Integration Services-Seite: Besuchen Sie die Integration Services-Seite auf MSDN Abonnieren Sie die auf der Seite verfügbaren RSS-Feeds, um automatische Benachrichtigungen zu diesen Updates zu erhalten.

Siehe auch

Aufgaben

Hinzufügen eines Ereignishandlers zu einem Paket

Konzepte

Integration Services-Ereignishandler (SSIS)