MessageQueueTask.InitializeTask Método

Definição

Namespace:

Microsoft.SqlServer.Dts.Tasks.MessageQueueTask

Assembly:

Microsoft.SqlServer.MSMQTask.dll

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.