Registrazione nell'attività ScriptLogging in the Script Task

L'utilizzo della registrazione nei pacchetti di Integration ServicesIntegration Services consente di registrare informazioni dettagliate su stato di esecuzione, risultati e problemi, tramite la registrazione di eventi predefiniti o di messaggi definiti dall'utente da analizzare in un secondo momento.The use of logging in Integration ServicesIntegration Services packages lets you record detailed information about execution progress, results, and problems by recording predefined events or user-defined messages for later analysis. L'attività Script può utilizzare il Log metodo il Dts oggetto da registrare dati definiti dall'utente.The Script task can use the Log method of the Dts object to log user-defined data. Se la registrazione è abilitata e il ScriptTaskLogEntry evento è selezionato per l'accesso il dettagli scheda della finestra il Configura log SSIS la finestra di dialogo, una singola chiamata al Log metodo archivia le informazioni sugli eventi in tutti i provider di log configurati per l'attività.If logging is enabled, and the ScriptTaskLogEntry event is selected for logging on the Details tab of the Configure SSIS Logs dialog box, a single call to the Log method stores the event information in all the log providers configured for the task.

Nota

Anche se è possibile eseguire direttamente la registrazione dall'attività Script, è consigliabile implementare eventi anziché registrare.Although you can perform logging directly from your Script task, you may want to consider implementing events rather than logging. Quando si utilizzano gli eventi, oltre ad abilitare la registrazione dei messaggi di eventi, è anche possibile rispondere all'evento con gestori eventi predefiniti o definiti dall'utente.When using events, not only can you enable the logging of event messages, but you can also respond to the event with default or user-defined event handlers.

Per ulteriori informazioni sulla registrazione, vedere Integration Services ( SSIS ) Registrazione.For more information about logging, see Integration Services (SSIS) Logging.

Esempio di registrazioneLogging Example

Nell'esempio seguente è illustrata la registrazione dall'attività Script registrando un valore che rappresenta il numero di righe elaborate.The following example demonstrates logging from the Script task by logging a value that represents the number of rows processed.

Public Sub Main()  

    Dim rowsProcessed As Integer = 100  
    Dim emptyBytes(0) As Byte  

    Try  
        Dts.Log("Rows processed: " & rowsProcessed.ToString, _  
            0, _  
            emptyBytes)  
        Dts.TaskResult = ScriptResults.Success  
    Catch ex As Exception  
        'An error occurred.  
        Dts.Events.FireError(0, "Script Task Example", _  
            ex.Message & ControlChars.CrLf & ex.StackTrace, _  
            String.Empty, 0)  
        Dts.TaskResult = ScriptResults.Failure  
    End Try  

End Sub  
using System;  
using System.Data;  
using Microsoft.SqlServer.Dts.Runtime;  

public class ScriptMain  
{  

    public void Main()  
        {  
            //  
            int rowsProcessed = 100;  
            byte[] emptyBytes = new byte[0];  

            try  
            {  
                Dts.Log("Rows processed: " + rowsProcessed.ToString(), 0, emptyBytes);  
                Dts.TaskResult = (int)ScriptResults.Success;  
            }  
            catch (Exception ex)  
            {  
                //An error occurred.  
                Dts.Events.FireError(0, "Script Task Example", ex.Message + "\r" + ex.StackTrace, String.Empty, 0);  
                Dts.TaskResult = (int)ScriptResults.Failure;  
            }  

        }  

}}

Risorse esterneExternal Resources

Vedere ancheSee Also

Integration Services ( SSIS ) RegistrazioneIntegration Services (SSIS) Logging