ScriptObjectModel.Events Propriedade

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

Valor da propriedade

A IDTSComponentEvents coleção de eventos existentes definida no pacote que contém a tarefa Script.

Exemplos

O exemplo a seguir de código para uso dentro de uma tarefa Script demonstra como gerar eventos dentro da tarefa Script. O exemplo utiliza uma função nativa da API do Windows para determinar se uma conexão com a Internet está disponível. Se não houver conexão disponível, gera um erro. Se uma conexão de modem potencialmente volátil estiver em uso, o exemplo levanta um alerta. Caso contrário, retorna uma mensagem informativa informando que uma conexão com a Internet foi detectada.

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  

Comentários

Use a Events propriedade do Dts objeto no código de tarefa do Script para gerar erros, avisos e mensagens de informação.