VariableDispenser.LockOneForRead Method

Статья
12/15/2008

Puts the variable in a list, and then locks it for read-only access.

Пространство имен: Microsoft.SqlServer.Dts.Runtime
Сборка: Microsoft.SqlServer.ManagedDTS (in microsoft.sqlserver.manageddts.dll)

Синтаксис

'Декларация
Public Sub LockOneForRead ( _
    variable As String, _
    ByRef variables As Variables _
)

public void LockOneForRead (
    string variable,
    ref Variables variables
)

public:
void LockOneForRead (
    String^ variable, 
    Variables^% variables
)

public void LockOneForRead (
    String variable, 
    /** @ref */ Variables variables
)

JScript не поддерживает передачу аргументов типа, содержащего значение, по ссылке.

Параметры

variable
The variable you want to lock for read-only access.

variables
The name of the variables collection to put the requested variable into.

Замечания

This method combines the work of the LockForRead method and the GetVariables method in one call, because it applies to a single variable only.

If the call succeeds, the requested variable is returned as a one-entry collection in the variable collection specified by the parameter variables, and the variable is locked for read-only access. To unlock the variable, release the variable collection by using the Unlock method of the Variables class. If the call to the LockOneForRead method fails, the variable is not locked.

Calls to this method do not affect the lock list generated via calls to LockForRead.

Примечание.
It is recommended that you do not make multiple calls to this method when acquiring locks for variables to be used together because this could lead to deadlocks. All variables being used together should be requested and locked together by using the methods LockForRead or LockForWrite, followed by a call to GetVariables.

If a lock was successful, you can clear it by calling Unlock.

Синхронизация потоков

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Платформы

Платформы разработки

Список поддерживаемых платформ см. в разделе Hardware and Software Requirements for Installing SQL Server 2005.

Целевые платформы

Список поддерживаемых платформ см. в разделе Hardware and Software Requirements for Installing SQL Server 2005.

См. также

Справочник

VariableDispenser Class
VariableDispenser Members
Microsoft.SqlServer.Dts.Runtime Namespace

Поделиться через