ScriptObjectModel.Events プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Scriptタスクを含むパッケージ内で定義された既存のイベントの IDTSComponentEvents コレクションを返します。
public:
property Microsoft::SqlServer::Dts::Tasks::ScriptTask::EventsObjectWrapper ^ Events { Microsoft::SqlServer::Dts::Tasks::ScriptTask::EventsObjectWrapper ^ get(); };
public Microsoft.SqlServer.Dts.Tasks.ScriptTask.EventsObjectWrapper Events { get; }
member this.Events : Microsoft.SqlServer.Dts.Tasks.ScriptTask.EventsObjectWrapper
Public ReadOnly Property Events As EventsObjectWrapper
プロパティ値
Scriptタスクを含むパッケージ内で定義された既存のイベントの IDTSComponentEvents 集合。
例
以下のスクリプトタスク内で使用されるコードのサンプルは、スクリプトタスク内でイベントを発生させる方法を示しています。 この例では、インターネット接続が利用可能かどうかを判定するために、ネイティブのWindows API関数を使用しています。 接続が利用できない場合はエラーが発生します。 不安定なモデム接続が使用されている場合、その例は警告を引き起こします。 そうでなければ、インターネット接続が検出されたという情報メッセージを返します。
Private Declare Function InternetGetConnectedState Lib "wininet" _
(ByRef dwFlags As Long, ByVal dwReserved As Long) As Long
Private Enum ConnectedStates
LAN = &H2
Modem = &H1
Proxy = &H4
Offline = &H20
Configured = &H40
RasInstalled = &H10
End Enum
Public Sub Main()
Dim dwFlags As Long
Dim connectedState As Long
connectedState = InternetGetConnectedState(dwFlags, 0)
If connectedState <> 0 Then
If (dwFlags And ConnectedStates.Modem) = ConnectedStates.Modem Then
Dts.Events.FireWarning(0, "Script Task Example", _
"Volatile Internet connection detected.", String.Empty, 0)
Else
Dts.Events.FireInformation(0, "Script Task Example", _
"Internet connection detected.", String.Empty, 0, False)
End If
Else
' If not connected to the Internet, raise an error.
Dts.Events.FireError(0, "Script Task Example", _
"Internet connection not available.", String.Empty, 0)
End If
Dts.TaskResult = ScriptResults.Success
End Sub
注釈
スクリプトタスクコードの Dts オブジェクトの Events プロパティを使ってエラー、警告、情報メッセージを発生させます。