Linguaggio

FtpTask.InitializeTask Metodo

Definizione

Inizializza le proprietà associate al compito. Questo metodo è chiamato dal runtime e non viene utilizzato nel codice.

public:
 override void InitializeTask(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log, Microsoft::SqlServer::Dts::Runtime::EventInfos ^ eventInfos, Microsoft::SqlServer::Dts::Runtime::LogEntryInfos ^ logEntryInfos, Microsoft::SqlServer::Dts::Runtime::ObjectReferenceTracker ^ refTracker);
public override void InitializeTask(Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log, Microsoft.SqlServer.Dts.Runtime.EventInfos eventInfos, Microsoft.SqlServer.Dts.Runtime.LogEntryInfos logEntryInfos, Microsoft.SqlServer.Dts.Runtime.ObjectReferenceTracker refTracker);
override this.InitializeTask : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging * Microsoft.SqlServer.Dts.Runtime.EventInfos * Microsoft.SqlServer.Dts.Runtime.LogEntryInfos * Microsoft.SqlServer.Dts.Runtime.ObjectReferenceTracker -> unit
Public Overrides Sub InitializeTask (connections As Connections, variableDispenser As VariableDispenser, events As IDTSInfoEvents, log As IDTSLogging, eventInfos As EventInfos, logEntryInfos As LogEntryInfos, refTracker As ObjectReferenceTracker)

Parametri

connections
Connections

Una raccolta di connessioni utilizzate per il compito.

variableDispenser
VariableDispenser

Un VariableDispenser oggetto per variabili di blocco.

events
IDTSInfoEvents

Un oggetto che implementa l'interfaccia IDTSInfoEvents per generare eventi (errori, avvisi e così via) durante la persistenza.

log
IDTSLogging

Oggetto che implementa l'interfaccia IDTSLogging .

eventInfos
EventInfos

Un oggetto EventInfos.

logEntryInfos
LogEntryInfos

La LogEntryInfos collezione utilizzata dal compito.

refTracker
ObjectReferenceTracker

Un tracciatore di riferimento per oggetti.

Esempio

Gli sviluppatori di task definiscono eventi personalizzati sovrascrivendo il InitializeTask metodo della Task classe base e creando un nuovo EventInfofile . Il seguente esempio di codice mostra il metodo InitializeTask di un task personalizzato, in cui vengono creati due eventi personalizzati e aggiunti alla collezione eventInfos.

public override void InitializeTask(Connections connections, VariableDispenser variables, IDTSInfoEvents events, IDTSLogging log, EventInfos eventInfos, LogEntryInfos logEntryInfos, ObjectReferenceTracker refTracker)  
{  
    this.eventInfos = eventInfos;  
    string[] paramNames = new string[1];  
    TypeCode[] paramTypes = new TypeCode[1]{TypeCode.Int32};  
    string[] paramDescriptions = new string[1];  

    paramNames[0] = "InitialValue";  
    paramDescriptions[0] = "The value before increment.";  

    this.eventInfos.Add("OnBeforeIncrement","Fires before the task increments the value.",true,paramNames,paramTypes,paramDescriptions);  
    this.onBeforeIncrement = this.eventInfos["OnBeforeIncrement"];  

    paramDescriptions[0] = "The value after increment.";  
    this.eventInfos.Add("OnAfterIncrement","Fires after the initial value is updated.",true,paramNames, paramTypes,paramDescriptions);  
    this.onAfterIncrement = this.eventInfos["OnAfterIncrement"];  
}  

Commenti

Per i FtpTask compiti stock e tutti gli altri, questo metodo viene utilizzato per impostare gli eventi logagrafici di ogni compito.

Il motore di esecuzione chiama InitializeTask immediatamente dopo la creazione del compito—prima delle operazioni di validazione, esecuzione o persistenza.

Si applica a