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.ServiceProvider
    Microsoft.VisualStudio.Data.ServiceProviderWithSite
      Microsoft.VisualStudio.Data.DataConnectionSupport
        Microsoft.VisualStudio.Data.AdoDotNet.AdoDotNetConnectionSupport

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

Sintaxe

'Declaração
Public MustInherit Class DataConnectionSupport _
    Inherits ServiceProviderWithSite _
    Implements IDisposable

public abstract class DataConnectionSupport : ServiceProviderWithSite, 
    IDisposable

public ref class DataConnectionSupport abstract : public ServiceProviderWithSite, 
    IDisposable

[<AbstractClass>]
type DataConnectionSupport =  
    class
        inherit ServiceProviderWithSite
        interface IDisposable
    end

public abstract class DataConnectionSupport extends ServiceProviderWithSite implements IDisposable

O tipo DataConnectionSupport expõe os membros a seguir.

Construtores

  Nome Descrição
Método protegido DataConnectionSupport Construtor da classe.Cria uma instância da classe nonparameterized de 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 especificados.
Propriedade pública ConnectionTimeout Obtém ou define a quantidade de tempo, em segundos, para esperar para estabelecer uma conexão antes de terminar a e tentativa de gerar um erro de tempo limite.
Propriedade pública ProviderObject Retorna o objeto do provedor de dados base para a conexão especificada.
Propriedade protegida ServiceTypes Recupera uma lista de tipos de serviço usados para converter a chamada não gerenciado do método de QueryService , em que um serviço GUID é especificado, gerenciado em uma chamada de método IServiceProvider.GetService , em que um tipo gerenciado é especificado. (Herdado de ServiceProvider.)
Propriedade pública Site Obtém ou define a instância do objeto do site. (Herdado de ServiceProviderWithSite.)
Propriedade pública State Recupera o estado da conexão de dados.

Superior

Métodos

  Nome Descrição
Método público Close Fecha a conexão especificada.
Método público Dispose() Executa as tarefas associadas com, liberar liberar, ou redefinir recursos.
Método protegido Dispose(Boolean) Executa as tarefas associadas com, liberar liberar, ou redefinir recursos.
Método público Equals determina se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegido Finalize Finaliza a conexão. (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 protegido GetServiceImpl(Type) Permite que você obtenha serviços de implementação. (Substitui ServiceProvider.GetServiceImpl(Type).)
Método protegido GetServiceImpl(Guid) Fornece a implementação para recuperar um serviço com um GUID específico. (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 OnSiteChanged Gera o evento SiteChanged. (Herdado de ServiceProviderWithSite.)
Método público Open Abre a conexão especificada.
Método protegido RaiseMessageReceived Gera o evento de MessageReceivedna instância incluindo de DataConnection .
Método protegido RaiseStateChanged Gera o evento changed estado na instância incluindo de DataConnection .
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 SiteChanged Evento gerado quando a propriedade de Site alterar. (Herdado de ServiceProviderWithSite.)

Superior

Implementações explícitas da interface

  Nome Descrição
Implementação explícita da interfaceMétodo particular IObjectWithSite.GetSite Retorna o conjunto o último de site usando o método de IObjectWithSite.SetSite .Se não houver nenhuma site conhecida, uma exceção é lançada. (Herdado de ServiceProviderWithSite.)
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.)
Implementação explícita da interfaceMétodo particular IObjectWithSite.SetSite Fornece o ponteiro de IUnknown de um site para um determinado objeto. (Herdado de ServiceProviderWithSite.)

Superior

Comentários

A classe de DataConnectionSupport representa a implementação do provedor de dados para dar suporte a uma conexão de dados.A arquitetura de DDEX implementa a classe de DataConnection chamando em DataConnectionSupport do provedor uma implementação específica.

As propriedades e métodos de essa classe fornecem 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 mais especializados substituindo o método de GetServiceImpl .Esses serviços conexão- relacionados são resumidas depois de:

  • DataViewSupport: Fornece um método para recuperar XML que descreve exibições específicas da fonte de dados dos objetos de dados a serem exibidos em gerenciador de servidores de Visual Studio .

  • DataObjectSupport: 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.

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

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

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

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

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

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

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

  • DataSourceInformation: Fornece um conjunto bem definido de pares nome-valor que descrevem a fonte de dados.

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

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 GetServiceImplpara fornecer os serviços de conexão.Quando uma alteração variável ou um evento mensagem- recebido ocorrem, uma classe derivada deve, sempre que possível, chame o RaiseStateChanged os métodos e protegidos de RaiseMessageReceived , que a classe base então passa sobre ao objeto de DataConnection localizado.

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

ServiceProviderWithSite

IDisposable