ObjectReferenceTracker.AddReference 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.
Metode ini menambahkan referensi ke daftar untuk pelacakan referensi.
public:
void AddReference(System::String ^ objectNameOrID, Microsoft::SqlServer::Dts::Runtime::DTSObjectReferenceType refType, int % refListID);public void AddReference (string objectNameOrID, Microsoft.SqlServer.Dts.Runtime.DTSObjectReferenceType refType, ref int refListID);member this.AddReference : string * Microsoft.SqlServer.Dts.Runtime.DTSObjectReferenceType * int -> unitPublic Sub AddReference (objectNameOrID As String, refType As DTSObjectReferenceType, ByRef refListID As Integer)Parameter
- objectNameOrID
- String
Nama objek atau ID objek yang memiliki daftar tempat Anda menambahkan referensi baru untuk pelacakan.
- refType
- DTSObjectReferenceType
Jenis referensi yang ingin Anda lacak. Nilai yang valid ditemukan dalam DTSObjectReferenceType enumerasi.
- refListID
- Int32
ID daftar referensi.
Keterangan
Metode ini menambahkan referensi untuk objek bernama dalam objectNameOrID parameter , dengan jenis yang ditentukan dalam refType, ke daftar referensi dengan yang diberikan refListID. Untuk membuat daftar, berikan nol untuk refListID. Setelah dikembalikan, refListID akan berisi ID daftar yang baru dibuat, yang sekarang berisi satu entri baru. Yang dikembalikan refListID dapat digunakan dalam panggilan berikutnya untuk menambahkan lebih banyak referensi ke daftar yang sama.
Metode ini menghapus seluruh daftar referensi dari sistem Pelacak Referensi. Ini harus dipanggil ketika objek yang memiliki daftar sedang dihancurkan. Ini juga berguna ketika objek yang memiliki daftar sedang disegarkan, dan daftar baru harus dibuat. Misalnya, dalam transformasi Pemisahan Bersyarat, jika ekspresi pada output diubah, daftar referensi untuk ekspresi tersebut dapat dihancurkan, dan daftar baru yang dibuat saat ekspresi baru diurai.
Parameter refListID dibuat ketika daftar baru dibuat menggunakan AddReference metode . Metode AddReference mengembalikan kepada Anda refListID, dan berisi ID daftar yang baru dibuat. Ini dikembalikan refListID dapat digunakan dalam panggilan berikutnya untuk menambahkan lebih banyak referensi ke daftar yang sama, menghapus referensi ke daftar, menghancurkan daftar, atau saat menggunakan SetListInfo metode .