VariableDispenser.LockOneForRead(String, Variables) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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.