VariableDispenser.LockOneForRead(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 somente leitura.

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

A variável a ser bloqueada para acesso somente leitura.

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 LockForRead 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 somente leitura. Para desbloquear a variável, libere a coleção de variáveis usando o Unlock método da Variables classe. Se a chamada para o LockOneForRead método falhar, a variável não será bloqueada.

As chamadas para esse método não afetam a lista de bloqueios gerada por meio de chamadas para LockForRead.

Observação

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

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