Partilhar 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

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 a quantidade de tempo para esperar estabelecer uma conexão antes de terminar e a 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 subjacentes, 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 os recursos mantidos pela conexão de dados.
Método protegido Dispose(Boolean) Libera os recursos mantidos pela conexão de dados.
Método público Equals Determines whether the specified object is equal to the current object. (Herdado de Object.)
Método protegido Finalize Libera os recursos mantidos pela conexão de dados quando o objeto de suporte de conexão de dados é destruído. (Substitui Object.Finalize.)
Método público GetHashCode Serves as the default hash function. (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 Gets the Type of the current instance. (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 Creates a shallow copy of the current Object. (Herdado de Object.)
Método protegido OnMessageReceived Manipule o evento de MessageReceived .
Método protegido OnSiteChanged Gera o evento SiteChanged. (Herdado de DataSiteableServiceProvider<T>.)
Método protegido OnStateChanged Manipule 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 Returns a string that represents the current object. (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 dessa 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 atual podem ser resumo de como segue:

  • 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 neles.

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

  • IVsDataObjectIdentifierConverter: Fornece métodos para converter entre a cadeia de caracteres e representações de 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 uma forma assíncrona.

  • IVsDataTransaction: Fornece a capacidade de começar, 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 para o 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 nele. Isso fornece a implementação com contexto, bem como um meio para recuperar 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 e métodos 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