Compartilhar via


MessageQueueTask.InitializeTask Método

Definição

Inicializa as propriedades associadas à tarefa. Esse método é chamado pelo runtime e não é usado em código.

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)

Parâmetros

connections
Connections

Uma coleção de conexões usada pela tarefa.

variableDispenser
VariableDispenser

Um objeto VariableDispenser para variáveis de bloqueio.

events
IDTSInfoEvents

Um objeto que implementa a interface IDTSInfoEvents.

log
IDTSLogging

Um objeto que implementa a interface IDTSLogging.

eventInfos
EventInfos

Uma coleção que contém eventos a serem gerados durante a execução da tarefa.

logEntryInfos
LogEntryInfos

Uma coleção de entradas de log.

refTracker
ObjectReferenceTracker

Um controlador de referência de objeto.

Exemplos

Os desenvolvedores de tarefas definem eventos personalizados substituindo o InitializeTask método da Task classe base e criando um novo EventInfo. O exemplo de código a seguir mostra o InitializeTask método de uma tarefa personalizada, em que dois eventos personalizados são criados e adicionados à eventInfos coleção.

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"];  
}  

Comentários

Para todas as MessageQueueTask outras tarefas de estoque, esse método é usado para definir os eventos de log de cada tarefa.

O mecanismo de runtime é chamado InitializeTask imediatamente após a criação da tarefa, antes das operações de validação, execução ou persistência.

Aplica-se a