XMLTask.InitializeTask Metodo
Definizione
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 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à.