言語

ScriptObjectModel.Events プロパティ

定義

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 プロパティを使ってエラー、警告、情報メッセージを発生させます。

適用対象