ConnectionManager 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.

Fournit les informations nécessaires pour vous connecter à une source de données. Toutes les classes qui héritent de l'objet ConnectionManager contiennent des propriétés et des méthodes identiques. La classe ConnectionManager isole du runtime les détails d'implémentation des différents types de connexions. Elle permet au runtime d'interagir avec chaque gestionnaire de connexions de façon cohérente et prévisible. Les gestionnaires de connexions contiennent un jeu de propriétés stock que toutes les connexions ont en commun, telles que les propriétés Name, ID, Description et ConnectionString. Toutefois, chaque type de connexion possède des propriétés supplémentaires qui lui sont spécifiques. Ces propriétés sont accessibles via la collection Properties. Cette classe ne peut pas être héritée.

public ref class ConnectionManager sealed : Microsoft::SqlServer::Dts::Runtime::DtsObject, IDisposable, Microsoft::SqlServer::Dts::Runtime::IDTSExecutionPath, Microsoft::SqlServer::Dts::Runtime::IDTSName, Microsoft::SqlServer::Dts::Runtime::IDTSObjectHost, Microsoft::SqlServer::Dts::Runtime::IDTSPackagePath, Microsoft::SqlServer::Dts::Runtime::IDTSPersist, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProvider, Microsoft::SqlServer::Dts::Runtime::IDTSPropertiesProviderEx, System::ComponentModel::IComponent

public sealed class ConnectionManager : Microsoft.SqlServer.Dts.Runtime.DtsObject, IDisposable, Microsoft.SqlServer.Dts.Runtime.IDTSExecutionPath, Microsoft.SqlServer.Dts.Runtime.IDTSName, Microsoft.SqlServer.Dts.Runtime.IDTSObjectHost, Microsoft.SqlServer.Dts.Runtime.IDTSPackagePath, Microsoft.SqlServer.Dts.Runtime.IDTSPersist, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProvider, Microsoft.SqlServer.Dts.Runtime.IDTSPropertiesProviderEx, System.ComponentModel.IComponent

type ConnectionManager = class
    inherit DtsObject
    interface IDTSObjectHost
    interface IDTSPersist
    interface IDTSName
    interface IComponent
    interface IDisposable
    interface IDTSPropertiesProvider
    interface IDTSPropertiesProviderEx
    interface IDTSPackagePath
    interface IDTSExecutionPath

Public NotInheritable Class ConnectionManager
Inherits DtsObject
Implements IComponent, IDisposable, IDTSExecutionPath, IDTSName, IDTSObjectHost, IDTSPackagePath, IDTSPersist, IDTSPropertiesProvider, IDTSPropertiesProviderEx

Héritage: Object

DtsObject
ConnectionManager

Implémente: IDTSExecutionPath IDTSName IDTSObjectHost IDTSPackagePath IDTSPersist IDTSPropertiesProvider IDTSPropertiesProviderEx IComponent IDisposable

Remarques

Un gestionnaire de connexions est une représentation logique d'une connexion. Au moment du design, dans l’interface utilisateur graphique, vous utilisez un gestionnaire de connexions pour décrire la connexion physique créée par le runtime lors de l’exécution du package. Integration Services fournit différents types de gestionnaires de connexions qui permettent aux packages de se connecter à diverses sources de données. Par exemple, il existe un gestionnaire de connexions ActiveX Data Objects (ADO), un gestionnaire de connexions ADO.NET, un gestionnaire de connexions ODBC, et ainsi de suite. Pour plus d’informations, consultez Extension de packages avec des objets personnalisés.

Propriétés

ConnectionString	Obtient ou définit la chaîne de connexion utilisée pour établir une connexion à une source de données.
CreationName	Retourne la chaîne utilisée par le runtime pour créer une instance de l'objet ConnectionManager et ajouter cet objet à la collection Connections. Cette propriété est en lecture seule.
DelayValidation	Obtient ou définit une valeur booléenne qui indique si la validation du package est retardée jusqu’à ce que le package s’exécute.
Description	Obtient ou définit la description de l'objet ConnectionManager.
HasExpressions	Obtient une valeur qui indique si le gestionnaire de connexions a des propriétés définies par des expressions.
HostType	Obtient une énumération qui décrit le type d'hôte qui utilise la connexion. Cette propriété est en lecture seule.
ID	Obtient l'ID de l'objet ConnectionManager. Cette propriété est en lecture seule.
InnerObject	Retourne le type de connexion spécifique qui a été créé. Cette propriété est en lecture seule.
Name	Obtient ou définit le nom de l'objet ConnectionManager.
OfflineMode	Obtient ou définit une valeur qui indique si le gestionnaire de connexions est en mode hors connexion.
Properties	Obtient une collection d'objets Property pour l'objet ConnectionManager. C'est la méthode utilisée pour accéder aux propriétés de la connexion spécifique, hébergée par le gestionnaire de connexions. Cette propriété est en lecture seule.
ProtectionLevel	Obtient ou définit le niveau de chiffrement effectué sur les données sensibles contenues dans le package.
Qualifier	Obtient ou définit le qualificateur du gestionnaire de connexions.
Scope	Obtient la portée du gestionnaire de connexions.
Site	Obtient ou définit le site du gestionnaire de connexions.
SupportsDTCTransactions	Retourne une valeur Boolean qui indique si la connexion prend en charge des transactions MS DTC (Microsoft Distributed Transaction Coordinator).
VariableDispenser	Obtient le distributeur de variables dans le gestionnaire de connexions.
Variables	Obtient la collection de variables dans le gestionnaire de connexions.

Méthodes

AcquireConnection(Object)	Crée une instance du type de connexion.
Dispose()	Libère les ressources utilisées par le ConnectionManager.
Equals(Object)	Détermine si les deux instances d'objet sont égales. (Hérité de DtsObject)
GetExecutionPath()	Retourne le chemin d'accès du gestionnaire de connexions.
GetExpression(String)	Retourne une chaîne qui contient l’expression de la propriété spécifiée. Null signifie qu’aucune expression n’a été affectée.
GetHashCode()	Retourne le code de hachage de cette instance. (Hérité de DtsObject)
GetPackagePath()	Obtient ou définit le chemin d'accès du package auquel la connexion s'applique.
LoadFromXML(String, IDTSEvents)	Cette méthode ne peut pas être appelée par votre code d'application. Pour charger un package qui a été enregistré en tant que .xml, utilisez la méthode LoadPackage(String, IDTSEvents).
LoadFromXML(XmlNode, IDTSEvents)	Cette méthode ne peut pas être appelée par votre code d'application. Pour charger un package qui a été enregistré en tant que .xml, utilisez la méthode LoadPackage(String, IDTSEvents).
ReleaseConnection(Object)	Libère la connexion établie pendant l'exécution de la méthode AcquireConnection(Object). Appelée au moment de la conception et au moment de l'exécution.
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Cette méthode ne peut pas être appelée par votre code d'application. Pour enregistrer un package en tant que .xml, utilisez la méthode SaveToXml(String, Package, IDTSEvents).
SetExpression(String, String)	Affecte l'expression spécifiée à la propriété. Spécifiez null pour supprimer une expression existante de la propriété.
SetQualifier(String)	Modifie un qualificateur sur le gestionnaire de connexions après la création du gestionnaire de connexions, mais avant qu'il soit utilisé dans un package en cours d'exécution.

Événements

Disposed

Ajoute un gestionnaire d'événements pour écouter l'événement Disposed sur l'objet ConnectionManager.

S’applique à