Variables Classe

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 , accessibles via 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 des variables utilisateur personnalisées. Lorsque vous créez un nouveau paquet, ajoutez un conteneur ou une tâche au paquet, 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 sont toujours situées dans l’espace System de 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 paquet s’exécute et l’heure de démarrage du paquet. Vous pouvez consulter les informations contenues dans une variable système, mais vous ne pouvez pas ajouter ou mettre à jour des variables système.

Vous pouvez aussi créer des variables personnalisées pour les utiliser dans des packages, conteneurs, tâches, transformations et contraintes de precedence. Des variables personnalisées peuvent être créées dans l’espace User de noms ou dans un espace de nom de votre choix. Des variables personnalisées peuvent être utilisées dans les expressions que peuvent contenir le conteneur de boucle For, la transformation Colonne dérivée, la transformation de Split conditionnelle et les contraintes de préséance. Pour plus d’informations, voir Utiliser des variables dans les paquets.

Chaque conteneur du modèle d’objets SSIS possède une Variables collection. Cette collection est accessible à chaque enfant du contenant. Une variable est accessible depuis la collection en utilisant son nom ou 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, offrant une collection visible globalement. Inversement, les variables contenues dans une tâche sont limitées en portée et en visibilité, et ne sont visibles que par la tâche.

Important

Le Variables est utilisé avec les classes d’exécution. Si vous utilisez des composantes de flux de données (Microsoft.SqlServer.Dts.Pipeline), il se peut que vous deviez utiliser le IDTSVariables100fichier . Pour savoir quelles collections de variables utiliser, consultez la documentation de l’objet sur lequel vous acquérez des variables, et vérifiez la valeur de retour.

Champs

Nom	Description
m_unmanagedColl	La collection non gérée. (Hérité de DTSReadOnlyCollectionBase)

Propriétés

Nom	Description
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 à l’objet DTSReadOnlyCollectionBase est synchronisé (thread-safe). (Hérité de DTSReadOnlyCollectionBase)
Item[Object]	Retourne un Variable objet de la Variables collection.
Locked	Un booléen indiquant si les variables de la Variables collection sont verrouillées.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès DTSReadOnlyCollectionBaseau . (Hérité de DTSReadOnlyCollectionBase)

Méthodes

Nom	Description
Add(String, Boolean, String, Object)	Ajoute un Variable objet à la Variables collection.
Contains(Object)	Retourne un booléen qui indique si les éléments de la collection peuvent être accessibles en utilisant l’indexation sans jeter d’exception.
CopyTo(Array, Int32)	Copie l’intégralité DTSReadOnlyCollectionBase dans un tableau unidimensionnel compatible, en commençant à l’index spécifié du tableau cible. (Hérité de DTSReadOnlyCollectionBase)
CreateManagedObject(Object)	Crée un objet géré à partir d’un objet non géré. (Hérité de DTSReadOnlyCollectionBase)
GetCount()	Récupère le nombre d’objets de la collection. (Hérité de DTSReadOnlyCollectionBase)
GetEnumerator()	Retourne un VariableEnumerator énumérateur pour l’itération sur la Variables collection.
GetManagedEnumerator(Object)	Obtient l’énumérateur géré d’un énumérateur non géré. (Hérité de DTSReadOnlyCollectionBase)
Join(Variable)	Rejoint le Variable à la Variables collection.
Remove(Object)	Supprime un Variable objet de la Variables collection.
Unlock()	Libère les verrous sur la collection de variables et signale l’état de la collection comme invalide ou inconnu.

S’applique à