LogProviderBase.Validate(IDTSInfoEvents) Metode

Referensi

Definisi

Ruang nama:: Microsoft.SqlServer.Dts.Runtime

Rakitan:: Microsoft.SqlServer.ManagedDTS.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.

Dipanggil untuk mengonfirmasi penyedia log dikonfigurasi dengan benar.

public:
 virtual Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::IDTSInfoEvents ^ events);

public virtual Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents events);

abstract member Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult
override this.Validate : Microsoft.SqlServer.Dts.Runtime.IDTSInfoEvents -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult

Public Overridable Function Validate (events As IDTSInfoEvents) As DTSExecResult

Parameter

events: IDTSInfoEvents

Antarmuka IDTSInfoEvents yang digunakan untuk menembakkan peristiwa informasi selama eksekusi paket.

Mengembalikan

DTSExecResult

Nilai dari DTSExecResult struktur yang menunjukkan keberhasilan atau kegagalan validasi.

Contoh

Contoh kode berikut menunjukkan cara memvalidasi objek menggunakan Validate metode Package objek .

DTSExecResult myresult = pkg.Validate(myPkgConnections, myPkgVariables, myIDTSEvents, myIDTSLogging);

Dim myresult As DTSExecResult =  pkg.Validate(myPkgConnections,myPkgVariables,myIDTSEvents, myIDTSLogging)

Keterangan

Metode ini Validate meninjau properti dan pengaturan untuk ketidakakuratan atau pengaturan yang salah. Metode ini tidak menyentuh data, atau menyambungkan ke sumber data untuk memvalidasi koneksi. Namun, ini memastikan bahwa bidang yang diperlukan diisi dan berisi nilai yang sesuai. Bidang yang divalidasi berbeda tergantung pada objek apa yang sedang divalidasi. Untuk Penyedia log, Validate metode memverifikasi bahwa properti dikonfigurasi ConfigString dengan benar dan properti atau pengaturan lain yang diperlukan dari penyedia log diatur seperti yang diharapkan. Penyedia log yang memerlukan koneksi ke sumber data eksternal melakukannya melalui penggunaan ConnectionManager objek. Properti ConfigString sering digunakan untuk menyimpan nama atau ID ConnectionManager dalam Connections koleksi.

Dalam hal ini, Validate harus memverifikasi bahwa ConnectionManager yang ditentukan dalam ConfigString properti ada dalam paket.

Jika Failure dikembalikan, eksekusi paket dibatalkan.

Penggunaan Validate utama adalah saat menulis tugas kustom. Metode Validate ini dipanggil oleh SSIS Designer ketika tugas dihilangkan ke permukaan desain dan sekali lagi, berpotensi beberapa kali, ketika properti sedang diatur. Namun, dalam kode, Validate metode pada objek individual tidak umum digunakan, karena disarankan agar Anda memanggil Validate metode pada Package saat Anda perlu memvalidasi objek. Namun, metode ini tersedia pada objek individual jika Anda menemukan keadaan unik di mana diperlukan.

Metode Validate ini ditimpa dalam tugas kustom, baik untuk validasi objek saat digunakan dalam Perancang SSIS, atau ketika dipanggil oleh kode. Untuk informasi selengkapnya tentang menulis Validate metode untuk tugas kustom, lihat Mengodekan Tugas Kustom.

Berlaku untuk