VariableDispenser.LockOneForRead(String, Variables) Método

Definición

Espacio de nombres:

Microsoft.SqlServer.Dts.Runtime

Ensamblado:

Microsoft.SqlServer.ManagedDTS.dll

Pone la variable en una lista y luego la bloquea para 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 quieres bloquear para el acceso de solo lectura.

variables

Variables

El nombre de la colección de variables en la que se debe poner la variable solicitada.

Comentarios

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

Si la llamada tiene éxito, la variable solicitada se devuelve como una colección de una sola entrada en la colección de variables especificada por el parámetro variables, y la variable queda bloqueada para acceso de solo lectura. Para desbloquear la variable, libera la colección de variables usando el Unlock método de la Variables clase. Si falla la llamada al LockOneForRead método, la variable no queda bloqueada.

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

Nota

Se recomienda no hacer múltiples llamadas a este método al adquirir bloqueos para variables que se usarán juntas, ya que esto podría provocar bloqueos. Todas las variables que se usen juntas deben solicitarse y bloquearse usando los métodos LockForRead o LockForWrite, seguidas de una llamada a GetVariables.

Si un bloqueo ha tenido éxito, puedes liberarlo llamando Unlocka .