Connexion aux sources de données dans le composant Script
Un gestionnaire de connexions est une unité pratique qui encapsule et stocke les informations requises pour se connecter à une source de données d'un type particulier. Pour plus d'informations, consultez Connexions Integration Services (SSIS).
Vous pouvez rendre accessibles des gestionnaires de connexions existants par le script personnalisé compris dans le composant source ou de destination en cliquant sur les boutons Ajouter et Supprimer de la page Gestionnaires de connexions de l'Éditeur de transformation de script. Toutefois, vous devez écrire votre propre code personnalisé pour charger ou enregistrer vos données et éventuellement ouvrir et fermer la connexion à la source de données. Pour plus d'informations sur la page Gestionnaires de connexions de l'Éditeur de transformation de script, consultez Configuration du composant Script dans l'éditeur de composant de script et Éditeur de transformation de script (Page Gestionnaire de connexions).
Le composant Script crée une classe de collection Connections dans l'élément de projet ComponentWrapper qui contient un accesseur fortement typé pour chaque gestionnaire de connexions qui porte le même nom que le gestionnaire de connexions lui-même. Cette collection est exposée via la propriété Connections de la classe ScriptMain. La propriété de l'accesseur renvoie une référence au gestionnaire de connexions sous forme d'instance de l'objet IDTSConnectionManager100. Par exemple, si vous avez ajouté un gestionnaire de connexion nommé MyADONETConnection dans la page Gestionnaires de connexions de la boîte de dialogue, vous pouvez obtenir une référence à ce dernier dans votre script en ajoutant le code suivant :
Dim myADONETConnectionManager As IDTSConnectionManager100 = _
Me.Connections.MyADONETConnection
[!REMARQUE]
Vous devez connaître le type de connexion renvoyé par le gestionnaire de connexions avant d'appeler AcquireConnection. Étant donné que la tâche de script a Option Strict activé, vous devez effectuer un cast de la connexion, qui est retournée en tant que type Object, vers le type de connexion approprié avant de pouvoir l'utiliser.
Ensuite, vous appelez la méthode AcquireConnection du gestionnaire de connexions spécifique pour obtenir soit la connexion sous-jacente, soit les informations requises pour vous connecter à la source de données. Par exemple, vous obtenez une référence à System.Data.SqlConnection encapsulé par un gestionnaire de connexions ADO.NET en utilisant le code suivant :
Dim myADOConnection As SqlConnection = _
CType(MyADONETConnectionManager.AcquireConnection(Nothing), SqlConnection)
Par opposition, le même appel d'un gestionnaire de connexions de fichier plat retourne uniquement le chemin d'accès et le nom de fichier de la source de données.
Dim myFlatFile As String = _
CType(MyFlatFileConnectionManager.AcquireConnection(Nothing), String)
Vous devez alors fournir ce chemin d'accès et ce nom de fichier à un System.IO.StreamReader ou Streamwriter pour lire ou écrire les données dans le fichier plat.
Important
Lorsque vous écrivez du code managé dans un composant Script, vous ne pouvez pas appeler la méthode AcquireConnection des gestionnaires de connexions qui retournent des objets non managés, tels que le gestionnaire de connexions OLE DB et le gestionnaire de connexions Excel. Toutefois, vous pouvez lire la propriété ConnectionString de ces gestionnaires de connexions et vous connecter directement à la source de données dans votre code en utilisant la chaîne de connexion d'un connection OLEDB à partir de l'espace de noms System.Data.OleDb.
Si vous devez appeler la méthode AcquireConnection d'un gestionnaire de connexions qui retourne un objet non managé, utilisez un gestionnaire de connexions ADO.NET. Lorsque vous configurez le gestionnaire de connexions ADO.NET afin d'utiliser un fournisseur OLE DB, il se connecte en utilisant le fournisseur de données .NET Framework pour OLE DB. Dans ce cas, la méthode AcquireConnection retourne un System.Data.OleDb.OleDbConnection au lieu d'un objet non managé. Pour configurer un gestionnaire de connexions ADO.NET pour une utilisation avec une source de données Excel, sélectionnez le fournisseur Microsoft OLE DB pour Jet, spécifiez un classeur Excel, puis entrez Excel 8.0 (pour Excel 97 et versions ultérieures) comme valeur Propriétés étendues dans la page Tout de la boîte de dialogue Gestionnaire de connexions.
Pour plus d'informations sur l'utilisation des gestionnaires de connexions avec le composant Script, consultez Création d'une source à l'aide du composant Script et Création d'une destination à l'aide du composant Script.
|
.gif "Icône Integration Services (petite)")
Rester à jour avec Integration ServicesVoir aussi
Tâches
Créer des gestionnaires de connexions