Variables Classe

Référence

Définition

Espace de noms:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Contient une collection d'objets Variables, qui sont accessibles par le biais de plusieurs objets. Cette classe ne peut pas être héritée.

public ref class Variables sealed : Microsoft::SqlServer::Dts::Runtime::DTSReadOnlyCollectionBase

public sealed class Variables : Microsoft.SqlServer.Dts.Runtime.DTSReadOnlyCollectionBase

type Variables = class
    inherit DTSReadOnlyCollectionBase

Public NotInheritable Class Variables
Inherits DTSReadOnlyCollectionBase

Héritage: Object

DTSReadOnlyCollectionBase
Variables

Remarques

Integration Services (SSIS) fournit des variables système et prend en charge les variables utilisateur personnalisées. Lorsque vous créez un package, ajoutez un conteneur ou une tâche au package ou créez un gestionnaire d’événements, SSIS inclut automatiquement un ensemble de variables système pour l’élément. Les variables système se trouvent toujours dans l’espace de System noms. System les variables contiennent des informations utiles sur le package et ses conteneurs, tâches et gestionnaires d’événements. System les variables contiennent des informations telles que le nom de l’ordinateur sur lequel le package s’exécute et l’heure de démarrage du package. Vous pouvez afficher les informations contenues dans une variable système, mais vous ne pouvez pas ajouter ou mettre à jour les variables système.

Vous pouvez également créer des variables personnalisées à utiliser dans des packages, des conteneurs, des tâches, des transformations et des contraintes de priorité. Les variables personnalisées peuvent être créées dans l’espace User de noms ou un espace de noms de votre choix. Les variables personnalisées peuvent être utilisées dans les expressions que le conteneur de boucles For, la transformation de colonne dérivée, la transformation de fractionnement conditionnel et les contraintes de précédence peuvent contenir. Pour plus d’informations, consultez Utiliser des variables dans les packages.

Chaque conteneur du modèle objet SSIS a une Variables collection. Cette collection est accessible à chaque enfant du conteneur. Une variable est accessible à partir de la collection à l’aide de son nom ou de son index. La Variables collection sur un conteneur représente une agrégation des variables dans la collection de son parent. La Variables collection de la Package classe est visible pour tous les objets du package, fournissant une collection globale visible. À l’inverse, les variables contenues dans une tâche sont limitées dans l’étendue et la visibilité, et ne sont visibles que par la tâche.

Important

Il Variables est utilisé avec les classes Runtime. Si vous utilisez des composants de flux de données (Microsoft.SqlServer.Dts.Pipeline), vous devrez peut-être utiliser le IDTSVariables100. Pour savoir quelle collection de variables utiliser, consultez la documentation de l’objet sur lequel vous achetez des variables et vérifiez la valeur de retour.

Champs

m_unmanagedColl

Collection non managée.

(Hérité de DTSReadOnlyCollectionBase)

Propriétés

Count	Obtient le nombre d'éléments contenus dans l'instance DTSReadOnlyCollectionBase. (Hérité de DTSReadOnlyCollectionBase)
IsSynchronized	Obtient une valeur qui indique si l’accès à DTSReadOnlyCollectionBase est synchronisé (thread-safe). (Hérité de DTSReadOnlyCollectionBase)
Item[Object]	Retourne un objet Variable à partir de la collection Variables.
Locked	Valeur booléenne indiquant si les variables de la Variables collection sont verrouillées.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à DTSReadOnlyCollectionBase. (Hérité de DTSReadOnlyCollectionBase)

Méthodes

Add(String, Boolean, String, Object)	Ajoute un objet Variable à la collection Variables.
Contains(Object)	Retourne une valeur booléenne qui indique si les éléments de la collection peuvent être accessibles à l’aide de l’indexation sans lever d’exception.
CopyTo(Array, Int32)	Copie l'ensemble du DTSReadOnlyCollectionBase dans un tableau compatible unidimensionnel en partant de l'index spécifié du tableau cible. (Hérité de DTSReadOnlyCollectionBase)
CreateManagedObject(Object)	Crée l'objet managé d'un objet non managé. (Hérité de DTSReadOnlyCollectionBase)
GetCount()	Récupère le nombre d'objets de la collection. (Hérité de DTSReadOnlyCollectionBase)
GetEnumerator()	Retourne un énumérateur VariableEnumerator à utiliser pour effectuer une itération au sein de la collection Variables.
GetManagedEnumerator(Object)	Obtient l'énumérateur managé d'un énumérateur non managé. (Hérité de DTSReadOnlyCollectionBase)
Join(Variable)	Joint Variable à la collection Variables.
Remove(Object)	Supprime un objet Variable de la collection Variables.
Unlock()	Libère les verrous sur la collection de variables et signale un état de la collection de variables non valide ou inconnu.

S’applique à