XMLTask.InitializeTask Metodo

Definizione

Inizializza le proprietà associate all'attività. Questo metodo viene chiamato dal runtime e non è 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

Raccolta di oggetti Connections utilizzati dall'attività.

variableDispenser
VariableDispenser

Oggetto VariableDispenser per il blocco di variabili.

events
IDTSInfoEvents

Oggetto che implementa l'interfaccia IDTSInfoEvents.

log
IDTSLogging

Oggetto che implementa l'interfaccia IDTSLogging.

eventInfos
EventInfos

Raccolta contenente gli eventi da generare durante l'esecuzione dell'attività.

logEntryInfos
LogEntryInfos

Raccolta di voci di log.

refTracker
ObjectReferenceTracker

Registrazione dei riferimenti agli oggetti.

Esempio

Gli sviluppatori di attività definiscono eventi personalizzati eseguendo l'override InitializeTask del metodo della Task classe di base e creando un nuovo EventInfooggetto . Nell'esempio di codice seguente viene illustrato il metodo InitializeTask di un'attività personalizzata, in cui vengono creati due eventi personalizzati e aggiunti all'insieme 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

XMLTask Per tutte le altre attività di magazzino, questo metodo viene usato per impostare gli eventi di log di ogni attività. Il motore di runtime chiama questo metodo immediatamente dopo la creazione dell'attività e prima delle operazioni di convalida, esecuzione o persistenza. Questo metodo non viene usato nel codice. Tuttavia, se si sta codificando un'attività personalizzata, potrebbe essere necessario eseguire l'override di questo metodo e fornire eventuali valori di inizializzazione per l'attività.

Si applica a