VariableDispenser.LockOneForWrite(String, Variables) Método

Definição

Namespace:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Coloca a variável em uma lista e, em seguida, bloqueia-a para acesso de leitura e gravação.

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

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

member this.LockOneForWrite : string * Variables -> unit

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

Parâmetros

variable

String

O nome da variável cujo acesso de leitura e gravação deve ser bloqueado.

variables

Variables

O nome da coleção de variáveis na qual a variável solicitada deve ser colocada.

Comentários

Esse método combina o trabalho do LockForWrite método e o GetVariables método em uma chamada, pois ele se aplica apenas a uma única variável.

Se a chamada for bem-sucedida, a variável solicitada será retornada como uma coleção de uma entrada na coleção de variáveis especificada pelo parâmetro variablese a variável será bloqueada para acesso de leitura/gravação. Para desbloquear a variável, libere a coleção de variáveis usando o Unlock método da classe Variables. Se a chamada do LockOneForWrite método falhar, a variável não será bloqueada.

As chamadas para esse método não afetam a lista de bloqueio gerada por chamadas para LockForWrite.

Observação

É recomendável que você não faça várias chamadas para esse método ao adquirir bloqueios para variáveis a serem usadas em conjunto, pois isso pode levar a deadlocks. Todas as variáveis que estão sendo usadas juntas devem ser solicitadas e bloqueadas juntas chamando os métodos LockForRead ou LockForWrite, seguidas por uma chamada ao GetVariables método.

Se um bloqueio tiver sido bem-sucedido, você poderá desmarcá-lo chamando Unlock.