XMLTask.InitializeTask Metode

Referensi

Definisi

Ruang nama:: Microsoft.SqlServer.Dts.Tasks.XMLTask

Rakitan:: Microsoft.SqlServer.XMLTask.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menginisialisasi properti yang terkait dengan tugas ini. Metode ini dipanggil oleh runtime dan tidak digunakan dalam kode.

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)

Parameter

connections: Connections

Kumpulan yang Connections digunakan oleh tugas.

variableDispenser: VariableDispenser

Objek VariableDispenser untuk mengunci variabel.

events: IDTSInfoEvents

Objek yang mengimplementasikan IDTSInfoEvents antarmuka.

log: IDTSLogging

Objek yang mengimplementasikan IDTSLogging antarmuka.

eventInfos: EventInfos

Koleksi yang berisi peristiwa yang akan dinaikkan selama eksekusi tugas.

logEntryInfos: LogEntryInfos

Kumpulan entri log.

refTracker: ObjectReferenceTracker

Pelacak referensi objek.

Contoh

Pengembang tugas menentukan peristiwa kustom dengan mengambil alih InitializeTask metode Task kelas dasar, dan membuat baru EventInfo. Sampel kode berikut menunjukkan metode InitializeTask dari tugas kustom, di mana dua peristiwa kustom dibuat, dan ditambahkan ke koleksi 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"];  
}

Keterangan

XMLTask Untuk dan semua tugas stok lainnya, metode ini digunakan untuk mengatur peristiwa log dari setiap tugas. Mesin run-time memanggil metode ini segera setelah tugas dibuat, dan sebelum operasi validasi, eksekusi, atau persistensi. Metode ini tidak digunakan dalam kode. Namun, jika Anda mengodekan tugas kustom, Anda mungkin perlu mengambil alih metode ini dan memberikan nilai inisialisasi apa pun untuk tugas Anda.

Berlaku untuk