XMLTask.Validate 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.

Memverifikasi bahwa komponen dikonfigurasi dengan benar.

public:
 override Microsoft::SqlServer::Dts::Runtime::DTSExecResult Validate(Microsoft::SqlServer::Dts::Runtime::Connections ^ connections, Microsoft::SqlServer::Dts::Runtime::VariableDispenser ^ variableDispenser, Microsoft::SqlServer::Dts::Runtime::IDTSComponentEvents ^ events, Microsoft::SqlServer::Dts::Runtime::IDTSLogging ^ log);

public override Microsoft.SqlServer.Dts.Runtime.DTSExecResult Validate (Microsoft.SqlServer.Dts.Runtime.Connections connections, Microsoft.SqlServer.Dts.Runtime.VariableDispenser variableDispenser, Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents events, Microsoft.SqlServer.Dts.Runtime.IDTSLogging log);

override this.Validate : Microsoft.SqlServer.Dts.Runtime.Connections * Microsoft.SqlServer.Dts.Runtime.VariableDispenser * Microsoft.SqlServer.Dts.Runtime.IDTSComponentEvents * Microsoft.SqlServer.Dts.Runtime.IDTSLogging -> Microsoft.SqlServer.Dts.Runtime.DTSExecResult

Public Overrides Function Validate (connections As Connections, variableDispenser As VariableDispenser, events As IDTSComponentEvents, log As IDTSLogging) As DTSExecResult

Parameter

connections: Connections

Kumpulan yang Connections digunakan oleh tugas.

variableDispenser: VariableDispenser

Objek VariableDispenser untuk mengunci variabel.

events: IDTSComponentEvents

Objek yang mengimplementasikan IDTSComponentEvents antarmuka.

log: IDTSLogging

Objek yang mengimplementasikan IDTSLogging antarmuka.

Mengembalikan

DTSExecResult

Nilai dari DTSExecResult enumerasi.

Contoh

Contoh kode berikut membuat XMLTask sebagai bagian dari paket. Setelah tugas dibuat, tugas mengatur beberapa properti, lalu memanggil Validate metode .Package

using System;  
using System.Collections.Generic;  
using System.Text;  
using Microsoft.SqlServer.Dts.Runtime;  
using Microsoft.SqlServer.Dts.Tasks.XMLTask;  

namespace XMLTask_API  
{  
        class Program  
        {  
        static void Main(string[] args)  

            // Set up the objects and tasks.  
            Package pkg = new Package();  
            Executable exec1 = pkg.Executables.Add("STOCK:XMLTask");  
            TaskHost th = exec1 as TaskHost;  
            XMLTask myTask = th.InnerObject as XMLTask;  

            // Create a FILE connection manager to books.xml.  
            ConnectionManager connMgr = pkg.Connections.Add("FILE");  
            connMgr.Name = "XMLConnectionManager";  
            // The file, Books.xml, is stored on the C:\ drive.  
            connMgr.ConnectionString = @"c:\books.xml";  

            // Set the XMLTask properties.  
            myTask.OperationType = DTSXMLOperation.Validate;  
            myTask.SourceType = DTSXMLSourceType.FileConnection;  
            myTask.Source = connMgr.Name;  

            DTSExecResult valResults = pkg.Validate(pkg.Connections, pkg.Variables, null, null);  
            Console.WriteLine("RESULTS: {0}", valResults);  
        }  
    }  
}

Contoh output:

RESULTS: Success

Keterangan

Metode ini tersedia untuk XMLTask, terlepas dari nilainya OperationType .

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.

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 SSIS Designer, atau ketika dipanggil oleh kode. Untuk informasi selengkapnya tentang menulis Validate metode untuk tugas kustom, lihat Pengodean Tugas Kustom.

Berlaku untuk

Bagikan melalui