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

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(...)

Integration Services (kleines Symbol) 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 der Integration Services-Seite von MSDN oder TechNet:

Abonnieren Sie die auf der Seite verfügbaren RSS-Newsfeeds, um automatische Benachrichtigungen zu diesen Aktualisierungen zu erhalten.