ObjectReferenceTracker Kelas

Definisi

Ruang nama:

Microsoft.SqlServer.Dts.Runtime

Rakitan:

Microsoft.SqlServer.ManagedDTS.dll

Memberikan analisis mengenai dampak dan konsekuensi penghapusan variabel dan koneksi dari paket. Kelas ini tidak dapat diwariskan.

public ref class ObjectReferenceTracker sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject

public sealed class ObjectReferenceTracker : Microsoft.SqlServer.Dts.Runtime.DtsObject

type ObjectReferenceTracker = class
    inherit DtsObject

Public NotInheritable Class ObjectReferenceTracker
Inherits DtsObject

Warisan

Object

DtsObject

ObjectReferenceTracker

Keterangan

ObjectReferenceTracker adalah mekanisme untuk melihat analisis dampak. Anda mendaftarkan objek yang digunakan komponen Anda dan di mana mereka ditemukan. Jika pengguna atau komponen lain mencoba menghapus objek, sistem dapat memberikan informasi yang memungkinkan Anda memverifikasi bahwa objek tidak digunakan di tempat lain, dan jika digunakan di tempat lain, tampilkan informasi kepada Anda. Saat Anda menambahkan atau menghapus referensi ke variabel dari komponen atau paket, Anda harus memperbarui daftar referensi variabel.

Saat ini, jenis objek yang didukung oleh pelacak referensi tercantum dalam DTSObjectReferenceType enumerasi.

Tugas runtime atau komponen alur yang menggunakan variabel atau koleksi menggunakan AddReference metode untuk membuat daftar referensi objek. Anda juga perlu memberikan lokasi penggunaan dan deskripsi untuk daftar dengan memanggil SetListInfo. Misalnya, tugas dengan satu variabel akan menggunakan namanya sebagai informasi lokasi, dan deskripsi tentang apa variabel digunakan sebagai deskripsi penggunaan.

Tugas atau komponen yang membuat penggunaan variabel atau koneksi yang berbeda dapat membuat daftar referensi terpisah sebanyak yang diperlukan. Misalnya, komponen Pemisahan Bersyar menggunakan variabel dalam ekspresi pada output, dan Anda dapat membuat daftar referensi terpisah untuk setiap ekspresi output yang menggunakan variabel. Anda mengatur nama komponen sebagai lokasi penggunaan dan menyertakan ekspresi dan tempatnya ditemukan dalam deskripsi. Jika variabel yang sama digunakan dalam beberapa ekspresi, setiap lokasi penggunaan akan dilacak oleh sistem.

Ada enumerasi terpisah DTSObjectReferenceType untuk variabel baca-saja dan variabel baca/tulis. Dengan menggunakan spesifikasi ini, bersama dengan penguncian variabel dengan VariableDispenser kelas , dapat memberikan informasi yang berguna saat menyelesaikan masalah kebuntuan.

Metode

AddReference(String, DTSObjectReferenceType, Int32)	Metode ini menambahkan referensi ke daftar untuk pelacakan referensi.
DestroyList(Int32)	Metode ini menghancurkan daftar referensi yang ditentukan dari pelacakan referensi.
Equals(Object)	Menentukan apakah dua instans objek sama. (Diperoleh dari DtsObject)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari DtsObject)
RemoveReference(String, DTSObjectReferenceType, Int32)	Menghapus referensi dari daftar yang sudah ada.
SetListInfo(Int32, String, String)	Metode ini memungkinkan Anda menyediakan metadata untuk daftar referensi yang ada.