• Article

Classe ConnectionManager

Provides the information that you must have to connect to a data source. All classes that inherit from the ConnectionManager contain the same properties and methods. The ConnectionManager class isolates the implementation details of the different connection types from the runtime. This enables the runtime to interact with each connection manager in a consistent and predictable manner. Connection managers contain a set of stock properties that all connections have in common, such as the Name, ID, Description, and ConnectionString. However, each connection type has additional properties that are specific to that connection type. These can be accessed through the Properties collection.This class cannot be inherited.

Hiérarchie d'héritage

System. . :: . .Object
  Microsoft.SqlServer.Dts.Runtime. . :: . .DtsObject
    Microsoft.SqlServer.Dts.Runtime..::..ConnectionManager

Espace de noms :  Microsoft.SqlServer.Dts.Runtime
Assembly :  Microsoft.SqlServer.ManagedDTS (en Microsoft.SqlServer.ManagedDTS.dll)

Syntaxe

'Déclaration
Public NotInheritable Class ConnectionManager _
    Inherits DtsObject _
    Implements IDTSObjectHost, IDTSPersist, IDTSName, IComponent,  _
    IDisposable, IDTSPropertiesProvider, IDTSPackagePath
'Utilisation
Dim instance As ConnectionManager

public sealed class ConnectionManager : DtsObject, 
    IDTSObjectHost, IDTSPersist, IDTSName, IComponent, IDisposable, 
    IDTSPropertiesProvider, IDTSPackagePath

public ref class ConnectionManager sealed : public DtsObject, 
    IDTSObjectHost, IDTSPersist, IDTSName, IComponent, IDisposable, 
    IDTSPropertiesProvider, IDTSPackagePath

[<SealedAttribute>]
type ConnectionManager =  
    class
        inherit DtsObject
        interface IDTSObjectHost
        interface IDTSPersist
        interface IDTSName
        interface IComponent
        interface IDisposable
        interface IDTSPropertiesProvider
        interface IDTSPackagePath
    end

public final class ConnectionManager extends DtsObject implements IDTSObjectHost, IDTSPersist, IDTSName, IComponent, IDisposable, IDTSPropertiesProvider, IDTSPackagePath

Le type ConnectionManager expose les membres suivants.

Propriétés

  Nom Description
Propriété publique ConnectionString Gets or sets the connection string used to establish a connection to a data source.
Propriété publique CreationName Returns the string that is used by the runtime to create an instance of the ConnectionManager object and to add the object to the Connections collection. This property is read-only.
Propriété publique DelayValidation Gets or sets a Boolean that indicates whether package validation is delayed until the package runs.
Propriété publique Description Gets or sets the description of the ConnectionManager object.
Propriété publique HostType Gets an enumeration that describes the type of host that the connection is being used by. This property is read-only.
Propriété publique ID Gets the ID of the ConnectionManager. This property is read-only.
Propriété publique InnerObject Returns the specific connection type that was created. This property is read-only.
Propriété publique Name Gets or sets the name of the ConnectionManager object.
Propriété publique Properties Gets a collection of property objects for the ConnectionManager. This is the method of accessing the properties of the specific connection that is being hosted by the connection manager. This property is read-only.
Propriété publique ProtectionLevel Gets or sets the level of encryption performed on sensitive data that is contained in the package.
Propriété publique Site Infrastructure.
Propriété publique SupportsDTCTransactions Returns a Boolean that indicates if the connection supports Microsoft Distributed Transaction Coordinator (MS DTC) transactions.

Haut de la page

Méthodes

  Nom Description
Méthode publique AcquireConnection Creates an instance of the connection type.
Méthode publique Dispose Releases the resources used by the ConnectionManager.
Méthode publique Equals Determines whether two object instances are equal. (hérité de DtsObject.)
Méthode protégée Finalize (hérité de Object.)
Méthode publique GetExpression Returns a String that contains the expression for the specified property. Null means that no expression has been assigned.
Méthode publique GetHashCode Returns the hash code for this instance. (hérité de DtsObject.)
Méthode publique GetPackagePath Gets or sets the path of the package that the connection applies to.
Méthode publique GetType (hérité de Object.)
Méthode publique LoadFromXML This method is not callable by your application code. To load a package that has been saved as .xml, use the Application..::..LoadPackage method.
Méthode protégée MemberwiseClone (hérité de Object.)
Méthode publique ReleaseConnection Frees the connection established during AcquireConnection. Called at design time and runtime.
Méthode publique SaveToXML This method is not callable by your application code. To save a package as .xml, use the Application..::..SaveToXml method.
Méthode publique SetExpression Assigns the specified expression to the property. Specify nullNothingnullptrunitune référence Null (Nothing dans Visual Basic) to remove an existing expression from the property.
Méthode publique SetQualifier Changes a qualifier on the connection manager after the connection manager has been created but before it is used in a running package.
Méthode publique ToString (hérité de Object.)

Haut de la page

Événements

  Nom Description
Événement public Disposed Adds an event handler to listen to the Disposed event on the ConnectionManager.

Haut de la page

Notes

A connection manager is a logical representation of a connection. At design time, in the graphical user interface, you use a connection manager to describe the physical connection that the runtime creates when the package runs. Integration Services provides different types of connection managers that enable packages to connect to a variety of data sources. For example, there is an ActiveX Data Objects (ADO) connection manager, an ADO.NET connection manager, an ODBC connection manager, and so on. For more information, see Extending Packages with Custom Objects.

Sécurité des threads

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.