ConnectionManager Classe
Définition
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 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
- 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. |