XMLTask.InitializeTask Metodo

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Dts.Tasks.XMLTask

Assembly:: Microsoft.SqlServer.XMLTask.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Inizializza le proprietà associate a questo 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 Connections usati dal compito.

variableDispenser: VariableDispenser

Un VariableDispenser oggetto per variabili di blocco.

events: IDTSInfoEvents

Oggetto che implementa l'interfaccia IDTSInfoEvents .

log: IDTSLogging

Oggetto che implementa l'interfaccia IDTSLogging .

eventInfos: EventInfos

Una raccolta che contiene gli eventi da generare durante l'esecuzione del compito.

logEntryInfos: LogEntryInfos

Una raccolta di registri di registro.

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 XMLTask compiti stock e tutti gli altri, questo metodo viene utilizzato per impostare gli eventi logagrafici di ogni compito. Il motore di esecuzione chiama questo metodo immediatamente dopo la creazione del compito e prima delle operazioni di validazione, esecuzione o persistenza. Questo metodo non è usato nel codice. Tuttavia, se stai programmando un compito personalizzato, potresti dover sovrascrivere questo metodo e fornire eventuali valori di inizializzazione per il tuo compito.

Si applica a