ConnectionManager Classe

Définition

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
ConnectionManager
Implémente

Remarques

Un gestionnaire de connexions est une représentation logique d'une connexion. Au moment de la conception, dans l’interface utilisateur graphique, vous utilisez un gestionnaire de connexions pour décrire la connexion physique que le runtime crée lors de l’exécution du package. Integration Services fournit différents types de gestionnaires de connexions qui permettent aux packages de se connecter à une variété de 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 différée jusqu’à l’exécution du package.

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 pour la propriété spécifiée. Null signifie qu’aucune expression n’a été assigné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 à