Compartilhar via

Classe DataConnectionSupport

  • Artigo

Fornece propriedades e métodos que permitem que você trabalhar diretamente com conexões com uma fonte de dados.

Hierarquia de herança

System.Object
  Microsoft.VisualStudio.Data.Framework.ServiceProvider
    Microsoft.VisualStudio.Data.Framework.DataSiteableServiceProvider<IVsDataConnection>
      Microsoft.VisualStudio.Data.Framework.DataConnectionSupport
        Microsoft.VisualStudio.Data.Framework.AdoDotNet.AdoDotNetConnectionSupport

Namespace:  Microsoft.VisualStudio.Data.Framework
Assembly:  Microsoft.VisualStudio.Data.Framework (em Microsoft.VisualStudio.Data.Framework.dll)

Sintaxe

'Declaração
Public MustInherit Class DataConnectionSupport _
    Inherits DataSiteableServiceProvider(Of IVsDataConnection) _
    Implements IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

public abstract class DataConnectionSupport : DataSiteableServiceProvider<IVsDataConnection>, 
    IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

public ref class DataConnectionSupport abstract : public DataSiteableServiceProvider<IVsDataConnection^>, 
    IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

[<AbstractClass>]
type DataConnectionSupport =  
    class
        inherit DataSiteableServiceProvider<IVsDataConnection>
        interface IVsDataConnectionSupport
        interface IServiceProvider
        interface IDisposable
        interface IVsDataConnectionEvents
    end

public abstract class DataConnectionSupport extends DataSiteableServiceProvider<IVsDataConnection> implements IVsDataConnectionSupport, IServiceProvider, IDisposable, IVsDataConnectionEvents

O tipo DataConnectionSupport expõe os membros a seguir.

Construtores

  Nome Descrição
Método protegido DataConnectionSupport Inicializa uma nova instância da classe DataConnectionSupport.

Superior

Propriedades

  Nome Descrição
Propriedade pública ConnectionString Obtém ou define uma representação de cadeia de caracteres de informações necessárias estabelecer uma conexão da fonte de dados especificada.
Propriedade pública ConnectionTimeout Obtém ou define o período de tempo para esperar estabelecer uma conexão antes de terminar a e tentativa de gerar um erro de tempo limite.
Propriedade protegida ParentProvider Obtém a instância atual do provedor de serviços pai. (Herdado de ServiceProvider.)
Propriedade pública ProviderObject Obtém o provedor de dados base, que oferece suporte a conexão de dados atual.
Propriedade protegida ServiceProvider Obtém o provedor de serviços global de Visual Studio .
Propriedade pública Site Obtém ou define o site. (Herdado de DataSiteableServiceProvider<T>.)
Propriedade pública State Obtém o estado da conexão de dados.

Superior

Métodos

  Nome Descrição
Método público AddService(Type, ServiceCreatorCallback) Adiciona o serviço especificado para a coleção interna de serviços. (Herdado de ServiceProvider.)
Método público AddService(Type, Object) Adiciona o serviço especificado para a coleção interna de serviços. (Herdado de ServiceProvider.)
Método público AddService(Type, ServiceCreatorCallback, Boolean) Adiciona o serviço especificado para a coleção interna de serviços ou para o contêiner pai do serviço. (Herdado de ServiceProvider.)
Método público AddService(Type, Object, Boolean) Adiciona o serviço especificado para a coleção de objetos ou de serviço para o contêiner pai do serviço. (Herdado de ServiceProvider.)
Método público Close Fecha a conexão especificada.
Método protegido CreateService Cria um novo objeto de serviço, especificando o tipo de serviço de interface.
Método público Dispose() Libera quaisquer recursos mantidos pela conexão de dados.
Método protegido Dispose(Boolean) Libera quaisquer recursos mantidos pela conexão de dados.
Método público Equals determina se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegido Finalize Libera quaisquer recursos mantidos pela conexão de dados quando o objeto de suporte a conexão de dados é destruído. (Substitui Object.Finalize().)
Método público GetHashCode Serve como uma função de hash para um tipo específico. (Herdado de Object.)
Método público GetService(Guid) Recupera um serviço com um serviço GUID especificado. (Herdado de ServiceProvider.)
Método público GetService(Type) Recupera um serviço do tipo especificado. (Herdado de ServiceProvider.)
Método público GetType Obtém Type da instância atual. (Herdado de Object.)
Método público Initialize Inicializa a conexão especificada, opcionalmente de um objeto do provedor de dados existente.
Método protegido MemberwiseClone Cria uma cópia superficial de Objectatual. (Herdado de Object.)
Método protegido OnMessageReceived Manipula o evento de MessageReceived .
Método protegido OnSiteChanged Gera o evento SiteChanged. (Herdado de DataSiteableServiceProvider<T>.)
Método protegido OnStateChanged Manipula o evento de StateChanged .
Método público Open Abre a conexão de dados especificada.
Método público RemoveService(Type) Remove o serviço especificado da coleção interna de serviços (Herdado de ServiceProvider.)
Método público RemoveService(Type, Boolean) Remove o serviço especificado da coleção interna de serviços ou recipiente pai do serviço. (Herdado de ServiceProvider.)
Método público ToString Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object.)

Superior

Eventos

  Nome Descrição
Evento público MessageReceived Ocorre quando uma mensagem for recebida da fonte de dados.
Evento público SiteChanged Ocorre quando o site alterar. (Herdado de DataSiteableServiceProvider<T>.)
Evento público StateChanged Ocorre quando o estado da conexão de dados alterar.

Superior

Implementações explícitas da interface

  Nome Descrição
Implementação explícita da interfaceMétodo particular IServiceProvider.QueryService Executa como uma fábrica para os serviços que são expostas com uma implementação de IServiceProvider. (Herdado de ServiceProvider.)

Superior

Comentários

A classe de DataConnectionSupport representa a implementação do provedor de dados para dar suporte a uma conexão de dados.

As propriedades e métodos de essa classe fornece a funcionalidade básica que permite que o provedor de dados se comunica com a fonte de dados, executando tarefas tais como abrir e fechar conexões e recuperar o estado da conexão.Um provedor de dados também pode expor serviços especializados substituindo o método de CreateService .Os serviços conexão- relacionados atuais podem ser resumo da seguinte maneira:

  • IVsDataObjectSupport: Fornece um método para recuperar XML que descreve tipos de objetos de dados suportados pela fonte de dados e as ações que podem ser executadas em eles.

  • IVsDataObjectIdentifierResolver: Fornece um método para resolver identificadores do objeto de dados.

  • IVsDataObjectIdentifierConverter: Fornece métodos para converter entre a cadeia de caracteres e representações do array de identificadores de objeto de dados.

  • IVsDataObjectMemberComparer: Fornece métodos para comparar as partes e valores de propriedade do identificador do objeto de dados.

  • IVsDataCommand: fornece a capacidade de derivar e executar vários tipos de comandos.

  • IVsDataAsyncCommand: Permite executar comandos de dados de forma assíncrona.

  • IVsDataTransaction: Fornece a capacidade de iniciar, confirmar, e reverter transações.

  • IVsDataSourceVersionComparer: Fornece um método para comparar duas cadeias de caracteres contém específicas de versão de dados.

  • IVsDataSourceInformation: Fornece um conjunto de bem definidos em pares nome/valor que descrevem a fonte de dados.

  • IVsDataMappedObjectConverter: Permite que fornece um mapeador personalizado de metadados específicos fonte de dados em conceitos conhecidos pelo uso de um designer genérico.

  • IVsDataObjectSelector: Permite obter contém metadados específicos de dados sobre os objetos definidos no arquivo XML de suporte do objeto de dados.

  • IDSRefBuilder: Fornece a capacidade de criar um objeto de (DSRef) de referência da fonte de dados que identifica um ou mais objetos de dados.

Essa classe implementa a interface de IVsDataSiteableObject<T> , que permite que DDEX localize a implementação de DataConnectionSupport de um provedor de dados com o objeto de IVsDataConnection que está chamando em ele.Isso fornece a implementação com contexto, bem como um meio para recuperar os serviços de Visual Studio .

Observações para herdeiros

Qualquer classe derivada deve implementar várias propriedades e métodos abstratos para oferecer suporte a conexão.Uma classe derivada também deve substituir o método protegido de CreateService para fornecer a implementação dos serviços de conexão.Quando uma alteração variável ou um evento mensagem- recebido ocorrem, uma classe derivada deve, quando possível, para chamar o OnStateChanged os métodos e protegidos de OnMessageReceived .

Acesso thread-safe

Quaisquer membros estático (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Consulte também

Referência

Namespace Microsoft.VisualStudio.Data.Framework