Compartilhar via


ConnectionManager Classe

Definição

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
ConnectionManager
Implementações

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