IDTSDesigntimeComponent100.Validate Metode
Definisi
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.
Memverifikasi bahwa komponen dikonfigurasi dengan benar.
public:
Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();[System.Runtime.InteropServices.DispId(29)]
public Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();[<System.Runtime.InteropServices.DispId(29)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatusPublic Function Validate () As DTSValidationStatusMengembalikan
Nilai dari DTSValidationStatus enumerasi yang menunjukkan status komponen.
- Atribut
Keterangan
Metode Validate ini diimplementasikan oleh pengembang komponen untuk memverifikasi bahwa komponen dikonfigurasi dengan benar. Ini dipanggil berulang kali selama desain paket, dan satu kali sebelum eksekusi komponen. Komponen tidak boleh memodifikasinya IDTSComponentMetaData100 selama Validate.
Setiap komponen memiliki persyaratan yang berbeda untuk validasi yang berhasil, tetapi daftar berikut menyediakan beberapa item umum yang harus divalidasi.
Verifikasi bahwa komponen memiliki jumlah IDTSInput100 objek dan IDTSOutput100 yang diharapkan.
Verifikasi bahwa objek apa pun IDTSCustomProperty100 terus ada dan berisi nilai yang benar.
Verifikasi bahwa setiap IDTSInputColumn100 objek dalam referensinya IDTSInputColumnCollection100 mereferensikan IDTSOutputColumn100 objek yang ada dalam komponen upstream.
Jika komponen menggunakan koneksi, verifikasi bahwa IDTSRuntimeConnection100 ditentukan dan bahwa ConnectionManager ada dalam paket.
Komponen harus memberikan umpan balik kepada pengguna ketika validasi gagal. Umpan balik diberikan melalui FireError metode dan FireWarning dan oleh nilai yang DTSValidationStatus dikembalikan. Panggilan ke FireError metode dan FireWarning ditampilkan di jendela Daftar Tugas di SQL Server Data Tools (SSDT), dan harus memberikan panduan kepada pengguna tentang kegagalan validasi. Dari empat nilai dalam DTSValidationStatus enumerasi, hanya VS_ISVALID menunjukkan validasi yang berhasil. Tiga nilai lainnya menunjukkan tingkat kegagalan yang berbeda. Tabel berikut ini menjelaskan nilai kegagalan dalam enumerasi dan bagaimana nilai tersebut ditafsirkan oleh SSIS Designer.
| Status | Deskripsi |
|---|---|
| VS_ISBROKEN | Menunjukkan bahwa komponen tidak dikonfigurasi dengan benar. Pengguna harus membuat perubahan pada ComponentMetaData untuk menyelesaikan masalah. |
| VS_NEEDSNEWMETADATA | Menunjukkan bahwa kesalahan validasi dapat diperbaiki oleh komponen dalam implementasi ReinitializeMetaData metode . Perancang SSIS akan meminta pengguna bahwa komponen dapat memperbaiki dirinya sendiri ketika nilai enumerasi adalah VS_NEEDSNEWMETADATA. Kemudian perancang akan memanggil ReinitializeMetaData metode . |
| VS_ISCORRUPT | Menunjukkan bahwa ComponentMetaData rusak dan tidak dapat diperbaiki dengan panggilan ke ReinitializeMetaData metode atau dengan mengedit komponen. |
DelayValidation Ketika properti tugas aliran data adalah true, panggilan waktu desain ke Validate metode dihilangkan, dan metode dipanggil sebelum eksekusi komponen sebagai gantinya.