ConnectionManager Classe

Définition

Fournit les informations nécessaires pour vous connecter à une source de données. Toutes les classes qui héritent de la ConnectionManager contiennent les mêmes propriétés et méthodes. La ConnectionManager classe isole les détails d’implémentation des différents types de connexion du temps d’exécution. Cela permet à l’exécution d’interagir avec chaque gestionnaire de connexion de manière cohérente et prévisible. Les gestionnaires de connexions contiennent un ensemble de propriétés de stock que toutes les connexions ont en commun, telles que le Name, ID, Description, et ConnectionString. Cependant, chaque type de connexion possède des propriétés supplémentaires propres à ce type de connexion. On peut y accéder via la Properties collection. 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
ConnectionManager
Implémente

Remarques

Un gestionnaire de connexion est une représentation logique d’une connexion. Au moment de la conception, dans l’interface graphique, vous utilisez un gestionnaire de connexion pour décrire la connexion physique que l’exécution crée lors de l’exécution du paquet. Integration Services propose différents types de gestionnaires de connexion permettant aux paquets de se connecter à une variété de sources de données. Par exemple, il existe un gestionnaire de connexion ActiveX Data Objects (ADO), un gestionnaire de connexion ADO.NET, un gestionnaire de connexion ODBC, etc. Pour plus d’informations, voir Extension des packages avec des objets personnalisés.

Propriétés

Nom Description
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 l’exécution pour créer une instance de l’objet ConnectionManager et l’ajouter à la Connections collection. Cette propriété est en lecture seule.

DelayValidation

Obtient ou définit un booléen qui indique si la validation du paquet est retardée jusqu’à l’exécution du paquet.

Description

Obtient ou définit la description de l’objet ConnectionManager .

HasExpressions

Obtient une valeur qui indique si le gestionnaire de connexion a des propriétés définies via 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 du 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 connexion est en mode hors ligne.

Properties

Obtient une collection d’objets propriétés pour le ConnectionManager. C’est la méthode d’accès aux propriétés de la connexion spécifique hébergée par le gestionnaire de connexion. 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 paquet.

Qualifier

Obtient ou définit le qualificateur pour le gestionnaire de connexion.

Scope

Ça comprend la portée du gestionnaire de connexion.

Site

Obtient ou définit le site du gestionnaire de connexion.

SupportsDTCTransactions

Retourne un Booléen indiquant si la connexion prend en charge les transactions du Microsoft Distributed Transaction Coordinator (MS DTC).

VariableDispenser

Obtient le distributeur des variables dans le gestionnaire de connexion.

Variables

Obtient la collection de variables dans le gestionnaire de connexions.

Méthodes

Nom Description
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 deux instances d’objet sont égales.

(Hérité de DtsObject)
GetExecutionPath()

Retourne le chemin d’exécution du gestionnaire de connexion.

GetExpression(String)

Retourne une chaîne contenant l’expression pour la propriété spécifiée. Nul signifie qu’aucune expression n’a été assignée.

GetHashCode()

Retourne le code de hachage pour cette instance.

(Hérité de DtsObject)
GetPackagePath()

Obtient ou définit le chemin du package auquel la connexion s’applique.

LoadFromXML(String, IDTSEvents)

Cette méthode n’est pas appelable par votre code d’application. Pour charger un colis qui a été sauvegardé en tant que .xml, utilisez la LoadPackage(String, IDTSEvents) méthode.

LoadFromXML(XmlNode, IDTSEvents)

Cette méthode n’est pas appelable par votre code d’application. Pour charger un colis qui a été sauvegardé en tant que .xml, utilisez la LoadPackage(String, IDTSEvents) méthode.

ReleaseConnection(Object)

Libère la connexion établie pendant AcquireConnection(Object). Appelée au moment de la conception et de l’exécution.

SaveToXML(XmlDocument, XmlNode, IDTSEvents)

Cette méthode n’est pas appelable par votre code d’application. Pour enregistrer un paquet en tant que .xml, utilisez la SaveToXml(String, Package, IDTSEvents) méthode.

SetExpression(String, String)

Attribue l’expression spécifiée à la propriété. Spécifier null pour retirer une expression existante de la propriété.

SetQualifier(String)

Modifie un qualificateur sur le gestionnaire de connexion après la création du gestionnaire de connexion mais avant qu’il ne soit utilisé dans un package en cours.

Événements

Nom Description
Disposed

Ajoute un gestionnaire d’événements pour écouter l’événement Disposed sur le ConnectionManager.

S’applique à