ConnectionManager Classe

Definizione

Spazio dei nomi:

Microsoft.SqlServer.Dts.Runtime

Assembly:

Microsoft.SqlServer.ManagedDTS.dll

Fornisce le informazioni necessarie per connettersi a un'origine dati. Tutte le classi che ereditano da ConnectionManager contengono le stesse proprietà e gli stessi metodi. La classe ConnectionManager isola i dettagli di implementazione dei diversi tipi di connessione dal runtime. In questo modo il runtime è in grado di interagire con ogni gestione connessione in modo coerente e stimabile. Le gestioni connessione contengono un set di proprietà predefinite comuni a tutte le connessioni, ad esempio Name, ID, Description e ConnectionString. Tuttavia, ciascun tipo di connessione dispone di proprietà aggiuntive specifiche per il tipo di connessione in questione. L'accesso a tali proprietà può essere eseguito tramite la raccolta Properties. Questa classe non può essere ereditata.

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

Ereditarietà

Object

DtsObject

ConnectionManager

Implementazioni

IDTSExecutionPath IDTSName IDTSObjectHost IDTSPackagePath IDTSPersist IDTSPropertiesProvider IDTSPropertiesProviderEx IComponent IDisposable

Commenti

Una gestione connessione è una rappresentazione logica di una connessione. In fase di progettazione, nell'interfaccia utente grafica si usa una gestione connessione per descrivere la connessione fisica creata dal runtime durante l'esecuzione del pacchetto. Integration Services offre diversi tipi di gestioni connessioni che consentono ai pacchetti di connettersi a un'ampia gamma di origini dati. Ad esempio, esiste una gestione connessione ActiveX Data Objects (ADO), una gestione connessione ADO.NET, una gestione connessione ODBC e così via. Per altre informazioni, vedere Estensione dei pacchetti con oggetti personalizzati.

Proprietà

ConnectionString	Ottiene o imposta la stringa di connessione utilizzata per stabilire una connessione a un'origine dati.
CreationName	Restituisce la stringa utilizzata dal runtime per creare un'istanza dell'oggetto ConnectionManager e aggiungerlo alla raccolta Connections. Questa proprietà è di sola lettura.
DelayValidation	Ottiene o imposta un valore booleano che indica se la convalida del pacchetto viene ritardata fino all'esecuzione del pacchetto.
Description	Ottiene o imposta la descrizione dell'oggetto ConnectionManager.
HasExpressions	Ottiene un valore che indica se la gestione connessione dispone di proprietà impostate tramite espressioni.
HostType	Ottiene un'enumerazione che descrive il tipo di host da cui verrà utilizzata la connessione. Questa proprietà è di sola lettura.
ID	Ottiene l'ID dell'oggetto ConnectionManager. Questa proprietà è di sola lettura.
InnerObject	Restituisce il tipo di connessione specifico creato. Questa proprietà è di sola lettura.
Name	Ottiene o imposta il nome dell'oggetto ConnectionManager.
OfflineMode	Ottiene o imposta un valore che indica se la gestione connessione viene eseguita in modalità offline.
Properties	Ottiene una raccolta di oggetti proprietà per ConnectionManager. Si tratta del metodo di accesso alle proprietà della connessione specifica ospitata dalla gestione connessione. Questa proprietà è di sola lettura.
ProtectionLevel	Ottiene o imposta il livello di crittografia eseguito su dati sensibili contenuti nel pacchetto.
Qualifier	Ottiene o imposta il qualificatore per la gestione connessione.
Scope	Ottiene l'ambito della gestione connessione.
Site	Ottiene o imposta il sito della gestione connessione.
SupportsDTCTransactions	Restituisce un valore booleano che indica se la connessione supporta le transazioni Microsoft Distributed Transaction Coordinator (MS DTC).
VariableDispenser	Ottiene il dispenser delle variabili nella gestione connessione.
Variables	Ottiene la raccolta di variabili nella gestione connessione.

Metodi

AcquireConnection(Object)	Crea un'istanza del tipo di connessione.
Dispose()	Rilascia le risorse usate da ConnectionManager.
Equals(Object)	Determina se due istanze di un oggetto sono uguali. (Ereditato da DtsObject)
GetExecutionPath()	Restituisce il percorso di esecuzione della gestione connessione.
GetExpression(String)	Restituisce un valore String che contiene l'espressione per la proprietà specificata. Null indica che non è stata assegnata alcuna espressione.
GetHashCode()	Restituisce il codice hash per l'istanza. (Ereditato da DtsObject)
GetPackagePath()	Ottiene o imposta il percorso del pacchetto al quale viene applicata la connessione.
LoadFromXML(String, IDTSEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per caricare un pacchetto salvato come file con estensione xml, utilizzare il metodo LoadPackage(String, IDTSEvents).
LoadFromXML(XmlNode, IDTSEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per caricare un pacchetto salvato come file con estensione xml, utilizzare il metodo LoadPackage(String, IDTSEvents).
ReleaseConnection(Object)	Libera la connessione stabilita durante AcquireConnection(Object). Viene chiamato in fase di progettazione e di esecuzione.
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Non è possibile chiamare questo metodo dal codice dell'applicazione. Per salvare un pacchetto come file con estensione xml, utilizzare il metodo SaveToXml(String, Package, IDTSEvents).
SetExpression(String, String)	Assegna l'espressione specificata alla proprietà. Specificare Null per rimuovere un'espressione esistente dalla proprietà.
SetQualifier(String)	Modifica un qualificatore della gestione connessione dopo che la gestione connessione è stata creata ma prima che venga utilizzata in un pacchetto in esecuzione.

Eventi

Disposed

Aggiunge un gestore eventi per restare in attesa dell'evento Disposed su ConnectionManager.