ConnectionManager Classe

Referência

Definição

Namespace:: Microsoft.SqlServer.Dts.Runtime

Assembly:: Microsoft.SqlServer.ManagedDTS.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece as informações que você deve ter para conectar a uma fonte de dados. Todas as classes que herdam de ConnectionManager contêm as mesmas propriedades e métodos. A classe ConnectionManager isola os detalhes de implementação dos diferentes tipos de conexão do runtime. Isso permite que o runtime interaja com cada gerenciador de conexões de uma maneira consistente e previsível. Gerenciadores de conexões contêm um conjunto de propriedades de estoque que todas as conexões têm em comum, como Name, ID, Description e ConnectionString. No entanto, cada tipo de conexão tem propriedades adicionais específicas a ele. Esses tipos podem ser acessados por meio da coleção Properties. Esta classe não pode ser herdada.

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

Herança: Object

DtsObject
ConnectionManager

Implementações: IDTSExecutionPath IDTSName IDTSObjectHost IDTSPackagePath IDTSPersist IDTSPropertiesProvider IDTSPropertiesProviderEx IComponent IDisposable

Comentários

Um gerenciador de conexões é uma representação lógica de uma conexão. Em tempo de design, na interface gráfica do usuário, você usa um gerenciador de conexões para descrever a conexão física que o runtime cria quando o pacote é executado. O Integration Services fornece diferentes tipos de gerenciadores de conexões que permitem que os pacotes se conectem a uma variedade de fontes de dados. Por exemplo, há um gerenciador de conexões ADO (ActiveX Data Objects), um gerenciador de conexões ADO.NET, um gerenciador de conexões ODBC e assim por diante. Para obter mais informações, consulte Estendendo pacotes com objetos personalizados.

Propriedades

ConnectionString	Obtém ou define a cadeia de conexão usada para estabelecer uma conexão com uma fonte de dados.
CreationName	Retorna a cadeia de caracteres usada pelo runtime para criar uma instância do objeto ConnectionManager e para adicionar o objeto à coleção Connections. Esta propriedade é somente para leitura.
DelayValidation	Obtém ou define um Boolean que indica se a validação do pacote está atrasada até que o pacote seja executado.
Description	Obtém ou define a descrição do objeto ConnectionManager.
HasExpressions	Obtém um valor que indica se o gerenciador de conexões tem propriedades definidas por expressões.
HostType	Obtém uma enumeração que descreve o tipo de host que está sendo usado pela conexão. Esta propriedade é somente para leitura.
ID	Obtém a ID do ConnectionManager. Esta propriedade é somente para leitura.
InnerObject	Retorna o tipo de conexão específico que foi criado. Esta propriedade é somente para leitura.
Name	Obtém ou define o nome do objeto ConnectionManager.
OfflineMode	Obtém ou define um valor que indica se o gerenciador de conexões está no modo offline.
Properties	Obtém uma coleção de objetos de propriedade para ConnectionManager. Este é o método de acessar as propriedades da conexão específica que está sendo hospedada pelo gerenciador de conexões. Esta propriedade é somente para leitura.
ProtectionLevel	Obtém ou define o nível de criptografia executado em dados confidenciais contidos no pacote.
Qualifier	Obtém ou define o qualificador do gerenciador de conexões.
Scope	Obtém o escopo do gerenciador de conexões.
Site	Obtém ou define o local do gerenciador de conexões.
SupportsDTCTransactions	Retorna um Boolean que indicará se a conexão tem suporte para transações do MS DTC (Microsoft Distributed Transaction Coordinator).
VariableDispenser	Obtém o dispensador das variáveis no gerenciador de conexões.
Variables	Obtém a coleção de variáveis no gerenciador de conexões.

Métodos

AcquireConnection(Object)	Cria uma instância do tipo de conexão.
Dispose()	Libera os recursos usados pelo ConnectionManager.
Equals(Object)	Determina se duas instâncias de objeto são iguais. (Herdado de DtsObject)
GetExecutionPath()	Retorna o caminho de execução do gerenciador de conexões.
GetExpression(String)	Retorna uma cadeia de caracteres que contém a expressão da propriedade especificada. Nulo significa que nenhuma expressão foi atribuída.
GetHashCode()	Retorna o código hash para a instância. (Herdado de DtsObject)
GetPackagePath()	Obtém ou define o caminho do pacote ao qual a conexão se aplica.
LoadFromXML(String, IDTSEvents)	Esse método não pode ser chamado por seu código de aplicativo. Para carregar um pacote salvo como .xml, use o método LoadPackage(String, IDTSEvents).
LoadFromXML(XmlNode, IDTSEvents)	Esse método não pode ser chamado por seu código de aplicativo. Para carregar um pacote salvo como .xml, use o método LoadPackage(String, IDTSEvents).
ReleaseConnection(Object)	Libera a conexão estabelecida durante AcquireConnection(Object). Chamado em tempo de design e em runtime.
SaveToXML(XmlDocument, XmlNode, IDTSEvents)	Esse método não pode ser chamado por seu código de aplicativo. Para salvar um pacote como .xml, use o método SaveToXml(String, Package, IDTSEvents).
SetExpression(String, String)	Atribui a expressão especificada à propriedade. Especifique nulo para remover uma expressão existente da propriedade.
SetQualifier(String)	Altera um qualificador no gerenciador de conexões, após a criação do gerenciador de conexões, mas antes de seu uso em um pacote em execução.

Eventos

Disposed

Adiciona um manipulador de eventos para escutar o evento Disposed no ConnectionManager.

Aplica-se a