Application.UpdateObjects Properti

Definisi

Ruang nama:

Microsoft.SqlServer.Dts.Runtime

Rakitan:

Microsoft.SqlServer.ManagedDTS.dll

Anggota tidak digunakan lagi; lihat Keterangan. Mendapatkan atau mengatur Boolean yang menunjukkan apakah objek yang dapat diperluas dapat diperbarui pada waktu pemuatan paket jika versi yang diperbarui ditemukan.

public:
 property bool UpdateObjects { bool get(); void set(bool value); };

public bool UpdateObjects { get; set; }

member this.UpdateObjects : bool with get, set

Public Property UpdateObjects As Boolean

Nilai Properti

Boolean

true jika objek yang dapat diperluas dapat diperbarui pada waktu pemuatan paket ketika versi yang diperbarui ditemukan; jika tidak, salah.

Contoh

Contoh kode berikut menunjukkan cara mengalihkan UpdateObjects properti untuk mengaktifkan atau mencegah pembaruan. Ini mengatur UpdateObjects ke true, mencetak nilai properti, mengaturnya ke false, dan mencetak nilai lagi.

class ApplicationTests  
    {  
        static void Main(string[] args)  
        {  
            Application app = new Application();  

            Boolean updateObjs = true;  
            app.UpdateObjects = updateObjs;  
            Console.WriteLine(app.UpdateObjects);  

            updateObjs = false;  
            app.UpdateObjects = updateObjs;  
            Console.WriteLine(app.UpdateObjects);  
        }  
    }  

Class ApplicationTests  
        Shared  Sub Main(ByVal args() As String)  
            Dim app As Application =  New Application()   

            Dim updateObjs As Boolean =  True   
            app.UpdateObjects = updateObjs  
            Console.WriteLine(app.UpdateObjects)  

            updateObjs = False  
            app.UpdateObjects = updateObjs  
            Console.WriteLine(app.UpdateObjects)  
        End Sub  
End Class  

Contoh Output:

True

False

Keterangan

Catatan

Anggota ini akan dihapus dalam versi MicrosoftSQL Server yang akan datang. Hindari menggunakan anggota ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan anggota ini.

Ketika versi baru objek yang dapat diperluas seperti tugas, Foreach enumerator, penyedia log, dan manajer koneksi tersedia, paket yang ada dapat diperbarui pada waktu pemuatan untuk mereferensikan objek baru. Anda dapat melakukan ini dengan mengatur ke UpdateObjectstrue sebelum memuat paket.

Setiap objek yang dapat diperluas mengimplementasikan CanUpdate properti . Runtime mencoba memuat paket yang ada, dan jika menemukan referensi ke objek yang lebih lama, paket mencoba memperbarui referensinya. Ini pertama-tama menghitung semua objek yang dapat diperluas yang dikandungnya, tidak Pipelinetermasuk , yang diperlakukan secara terpisah dan lokal, dan untuk setiap objek, memanggil CanUpdate objek baru yang melewati ID yang lama. Jika objek baru dapat memperbarui objek lama, objek lama diteruskan ke objek baru melalui Update metode , dan XML diubah di tempatnya. Secara default, semua objek yang dapat diperluas diterapkan CanUpdate untuk mengembalikan false, dalam hal ini Update tidak melakukan apa pun ke XML yang diteruskan.