VariableDispenser.LockOneForRead(String, Variables) Metode

Definisi

Ruang nama:

Microsoft.SqlServer.Dts.Runtime

Rakitan:

Microsoft.SqlServer.ManagedDTS.dll

Menempatkan variabel dalam daftar, lalu menguncinya untuk akses baca-saja.

public:
 void LockOneForRead(System::String ^ variable, Microsoft::SqlServer::Dts::Runtime::Variables ^ % variables);

public void LockOneForRead (string variable, ref Microsoft.SqlServer.Dts.Runtime.Variables variables);

member this.LockOneForRead : string * Variables -> unit

Public Sub LockOneForRead (variable As String, ByRef variables As Variables)

Parameter

variable

String

Variabel yang ingin Anda kunci untuk akses baca-saja.

variables

Variables

Nama koleksi variabel untuk memasukkan variabel yang diminta.

Keterangan

Metode ini menggabungkan pekerjaan LockForRead metode dan GetVariables metode dalam satu panggilan, karena hanya berlaku untuk satu variabel.

Jika panggilan berhasil, variabel yang diminta dikembalikan sebagai koleksi satu entri dalam koleksi variabel yang ditentukan oleh parameter variables, dan variabel dikunci untuk akses baca-saja. Untuk membuka kunci variabel, lepaskan koleksi variabel dengan menggunakan Unlock metode Variables kelas . Jika panggilan ke LockOneForRead metode gagal, variabel tidak dikunci.

Panggilan ke metode ini tidak memengaruhi daftar kunci yang dihasilkan melalui panggilan ke LockForRead.

Catatan

Disarankan agar Anda tidak melakukan beberapa panggilan ke metode ini saat memperoleh kunci untuk variabel yang akan digunakan bersama-sama karena ini dapat menyebabkan kebuntuan. Semua variabel yang digunakan bersama-sama harus diminta dan dikunci bersama dengan menggunakan metode LockForRead atau LockForWrite, diikuti dengan panggilan ke GetVariables.

Jika kunci berhasil, Anda dapat menghapusnya dengan memanggil Unlock.