VariableDispenser.LockOneForRead(String, Variables) Método

Definición

Espacio de nombres:

Microsoft.SqlServer.Dts.Runtime

Ensamblado:

Microsoft.SqlServer.ManagedDTS.dll

Coloca la variable en una lista y, a continuación, la bloquea para el acceso de solo lectura.

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)

Parámetros

variable

String

La variable que desea bloquear para el acceso de solo lectura.

variables

Variables

El nombre de la colección de variables en el que se va a colocar la variable solicitada.

Comentarios

Este método combina el trabajo del LockForRead método y el GetVariables método en una llamada, ya que solo se aplica a una sola variable.

Si la llamada se realiza correctamente, la variable solicitada se devuelve como una colección de una entrada en la colección de variables especificada por el parámetro variablesy la variable está bloqueada para el acceso de solo lectura. Para desbloquear la variable, libere la colección de variables mediante el Unlock método de la Variables clase . Si se produce un error en la llamada al LockOneForRead método , la variable no está bloqueada.

Las llamadas a este método no afectan a la lista de bloqueos generada a través de llamadas a LockForRead.

Nota

Se recomienda no realizar varias llamadas a este método al adquirir bloqueos para que las variables se usen juntas, ya que esto podría provocar interbloqueos. Todas las variables que se usan juntas deben solicitarse y bloquearse juntas mediante los métodos LockForRead o LockForWrite, seguidos de una llamada a GetVariables.

Si un bloqueo se realizó correctamente, puede borrarlo llamando a Unlock.