VariableDispenser.LockOneForRead(String, Variables) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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.