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