VariableDispenser Classe

Définition

public ref class VariableDispenser sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject

public sealed class VariableDispenser : Microsoft.SqlServer.Dts.Runtime.DtsObject

type VariableDispenser = class
    inherit DtsObject

Public NotInheritable Class VariableDispenser
Inherits DtsObject

Héritage

Object

DtsObject

VariableDispenser

Remarques

Il existe deux scénarios pour utiliser le distributeur variable.

1. Il ne faut qu’une seule variable. Dans ce scénario, appelez LockOneForRead ou LockOneForWrite, et une collection contenant un élément est retournée.

2. Il faut plusieurs variables. Dans ce scénario, appelez LockForRead et LockForWrite plusieurs fois, une pour chaque variable. Cela constitue deux listes, une liste contenant des variables à lire et une liste contenant des variables à écrire. Ensuite, appelez GetVariables, ce qui vous donne une collection contenant toutes les variables verrouillées. Si GetVariables elle réussit, les deux listes, qui sont les listes de noms de variables et non de verrous réels, sont effacées.

Pour libérer explicitement les serrures, faites Unlock appel à la collection. Cette méthode débloque les variables elles-mêmes. Si GetVariables ça échoue, les listes restent inchangées et vous pouvez rappeler GetVariables . Si vous n’arrivez toujours pas à obtenir les variables, appelez Reset pour effacer les listes et ramener le distributeur de variables à son état initial.

La Variables collection contient une Locked propriété qui indique si une collection de variables distributeur de variables est verrouillée (true) ou déverrouillée (false). La raison de revoir cette propriété est que certaines tâches libèrent explicitement des verrous sur les variables qu’elles utilisent, et appeler Unlock deux fois génère une erreur. Par conséquent, vous devriez utiliser cette propriété pour déterminer si la collecte délivrée est verrouillée avant d’appeler Unlock.