VariableDispenser Kelas

Definisi

Ruang nama:

Microsoft.SqlServer.Dts.Runtime

Rakitan:

Microsoft.SqlServer.ManagedDTS.dll

Variables Mengakses koleksi selama eksekusi paket. Kelas ini tidak dapat diwariskan.

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

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

type VariableDispenser = class
    inherit DtsObject

Public NotInheritable Class VariableDispenser
Inherits DtsObject

Warisan

Object

DtsObject

VariableDispenser

Keterangan

Ada dua skenario untuk menggunakan dispenser variabel.

1. Anda hanya ingin satu variabel. Dalam skenario ini, panggil LockOneForRead atau LockOneForWrite, dan koleksi dengan satu elemen dikembalikan.

2. Anda menginginkan beberapa variabel. Dalam skenario ini, panggil LockForRead dan LockForWrite beberapa kali, satu untuk setiap variabel. Ini menyusun dua daftar, satu daftar yang berisi variabel untuk dibaca dan satu daftar yang berisi variabel untuk ditulis. Selanjutnya, panggil GetVariables, yang memberi Anda koleksi yang berisi semua variabel terkunci. Jika GetVariables berhasil, dua daftar, yang merupakan daftar nama variabel, bukan kunci aktual, dibersihkan.

Untuk melepaskan kunci secara eksplisit, panggil Unlock pada koleksi. Metode ini membuka variabel itu sendiri. Jika GetVariables gagal, daftar tetap tidak berubah, dan Anda dapat memanggil GetVariables lagi. Jika Anda masih tidak berhasil mendapatkan variabel, panggil Reset untuk menghapus daftar dan membawa dispenser variabel kembali ke status awalnya.

Koleksi Variables berisi Locked properti yang menunjukkan apakah kumpulan variabel dispenser variabel terkunci (true) atau tidak terkunci (false). Alasan untuk meninjau properti ini adalah bahwa beberapa tugas secara eksplisit melepaskan kunci ke variabel yang mereka gunakan, dan memanggil Unlock dua kali melemparkan kesalahan. Oleh karena itu, Anda harus menggunakan properti ini untuk menentukan apakah koleksi yang dispensasi dikunci sebelum memanggil Unlock.

Penting

VariableDispenser digunakan dengan kelas Runtime. Jika Anda menggunakan komponen aliran data (Microsoft.SqlServer.Dts.Pipeline), anda mungkin diharuskan untuk menggunakan sebagai gantinya IDTSVariableDispenser100 . Untuk mengetahui dispenser variabel mana yang akan digunakan, lihat dokumentasi untuk objek tempat Anda memperoleh variabel, dan verifikasi objek pengembalian metode.

Metode

Contains(String)	Menentukan apakah item dapat diambil dari VariableDispenser koleksi dengan menggunakan pengindeksan tanpa melemparkan pengecualian.
Equals(Object)	Menentukan apakah dua instans objek sama. (Diperoleh dari DtsObject)
GetHashCode()	Mengembalikan kode hash untuk instans ini. (Diperoleh dari DtsObject)
GetQualifiedName(String)	Mengembalikan nama variabel yang memenuhi syarat.
GetVariables(Variables)	Mengunci variabel yang ada dalam daftar baca-saja dan daftar baca/tulis.
LockForRead(String)	Menambahkan variabel ke daftar variabel yang akan dikunci untuk akses baca-saja.
LockForWrite(String)	Menambahkan variabel ke daftar variabel yang akan dikunci untuk akses baca/tulis.
LockOneForRead(String, Variables)	Menempatkan variabel dalam daftar, lalu menguncinya untuk akses baca-saja.
LockOneForWrite(String, Variables)	Menempatkan variabel dalam daftar, lalu menguncinya untuk akses baca/tulis.
Reset()	Menghapus daftar baca-saja dan daftar baca/tulis saat panggilan gagal GetVariables(Variables) .