Partilhar via

Classe DataConnection

  • Artigo

Suporta uma conexão a uma fonte de dados.

Hierarquia de herança

System.Object
  Microsoft.VisualStudio.Data.ServiceProvider
    Microsoft.VisualStudio.Data.DataConnection

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

Sintaxe

'Declaração
Public MustInherit Class DataConnection _
    Inherits ServiceProvider _
    Implements ICloneable, IDisposable

public abstract class DataConnection : ServiceProvider, 
    ICloneable, IDisposable

public ref class DataConnection abstract : public ServiceProvider, 
    ICloneable, IDisposable

[<AbstractClass>]
type DataConnection =  
    class
        inherit ServiceProvider
        interface ICloneable
        interface IDisposable
    end

public abstract class DataConnection extends ServiceProvider implements ICloneable, IDisposable

O tipo DataConnection expõe os membros a seguir.

Construtores

  Nome Descrição
Método protegido DataConnection Construtor da classe.Cria uma nova instância da classe de DataConnection .

Superior

Propriedades

  Nome Descrição
Propriedade pública AsyncCommand Recupera um objeto que pode executar a derivação assíncrona e a execução de comandos na fonte de dados.
Propriedade pública Command Recupera um objeto que pode executar a derivação e execução de comandos na fonte de dados.
Propriedade pública ConnectionSupport Retorna o objeto de suporte de conexão do provedor de dados subjacentes que está sendo usado para oferecer suporte à instância atual de conexão de dados.
Propriedade pública ConnectionTimeout Obtém ou define a quantidade de tempo, em segundos, antes de um comando abra o tempo limite de uma conexão.
Propriedade pública DisplayConnectionString Obtém ou define informações não criptografado de conexão na forma de cadeia de caracteres DDEX-provedor- específica.
Propriedade pública EncryptedConnectionString Obtém ou define informações criptografadas de conexão na forma de cadeia de caracteres DPAPI- criptografadas, específica do provedor.
Propriedade pública IsLockedForExclusiveAccess Retorna um valor Booleano que indica se a conexão atual será bloqueada por um cliente para acesso exclusivo.
Propriedade pública ObjectChangeEvents Recupera um objeto que fornece um conjunto de eventos disparados quando os objetos de dados na fonte de dados são adicionados, removidos, modificados ou.
Propriedade pública ObjectIdentifierConverter Recupera um objeto que pode converter identificadores do objeto de dados de cadeias de caracteres formatadas a partes sem formatação e vice-versa.
Propriedade pública ObjectIdentifierResolver Recupera um objeto que pode resolver identificadores do objeto de dados com expansão e a contração.
Propriedade pública ObjectItemComparer Recupera um objeto que possa comparar as partes as propriedades e do identificador em objetos de dados.
Propriedade pública ObjectSupport Recupera um objeto que fornece um fluxo XML que define vários tipos de objeto de dados de DDEX suportados pela conexão de dados atual.
Propriedade pública Provider Recupera o identificador exclusivo do provedor de DDEX para a conexão de dados atual.
Propriedade pública ProviderObjectIsLocked Retorna um valor Booleano que indica se o objeto subjacente do provedor de DDEX está bloqueado para o uso de um cliente.
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 Source Recupera o identificador exclusivo (GUID) da fonte de dados para a conexão de dados atual, se houver.
Propriedade pública SourceInformation Recupera um objeto que fornece um conjunto de conhecidos de pares nome/valor que descrevem as características da fonte de dados.
Propriedade pública SourceVersionComparer Recupera um objeto que permite que você compare números de versão dados-origem- específicos.
Propriedade pública State Recupera o estado atual da conexão de dados.
Propriedade pública Transaction Recupera um objeto que permite o processamento de transações; isto é, permite que você inicie, confirme, e as transações de reversão na fonte de dados.
Propriedade pública ViewSupport Recupera um objeto que fornece um fluxo XML que define os vários modos de exibição de dados suportadas pela conexão de dados atual.

Superior

Métodos

  Nome Descrição
Método público Clone Cria uma instância de esta clonados conexão de dados, que retém as mesmas propriedades e estado de conexão que o original.
Método público Close Fecha a conexão de dados atual.
Método público Dispose() Descarte de conexão de dados atual e todos os seus recursos associados.
Método protegido Dispose(Boolean) Oferece suporte a infra-estrutura de DDEX e não se destina a ser usado diretamente do seu código.
Método público Equals determina se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método público EquivalentTo Retorna um valor Booleano que indica se informações sobre a conexão atual, é equivalente em uma noção de tempo de design, às informações de conexão especificada.
Método protegido Finalize Finaliza a conexão. (Substitui Object.Finalize().)
Método público GetExclusiveAccessProxy Recupera uma instância de proxy que permite ao chamador acesso exclusivo a conexão de dados.
Método público GetHashCode Serve como uma função de hash para um tipo específico. (Herdado de Object.)
Método público GetLockedProviderObject() Retorna o objeto do provedor de dados subjacentes, se houver, que oferece suporte a conexão de dados atual.
Método público GetLockedProviderObject(Int32) Retorna o objeto do provedor de dados subjacentes, se houver, que oferece suporte a conexão de dados atual.
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(Guid) Fornece a implementação para recuperar um serviço com um GUID específico. (Herdado de ServiceProvider.)
Método protegido GetServiceImpl(Type) Fornece a implementação para recuperar um serviço de um tipo específico. (Herdado de ServiceProvider.)
Método público GetType Obtém Type da instância atual. (Herdado de Object.)
Método protegido MemberwiseClone Cria uma cópia superficial de Objectatual. (Herdado de Object.)
Método protegido OnMessageReceived Manipulador para o evento de MessageReceived .
Método protegido OnStateChanged Manipulador para o evento de StateChanged .
Método público Open Abrir esta conexão de dados.
Método público ReleaseExclusiveAccessProxy Libera um proxy exclusivo existente de acesso, de maneira esperada com uma chamada ao método de GetExclusiveAccessProxy .
Método público ToString Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object.)
Método público UnlockProviderObject Desbloqueia um objeto do provedor de DDEX que está bloqueado usando uma chamada para o método de GetLockedProviderObject.

Superior

Eventos

  Nome Descrição
Evento público MessageReceived Evento que é gerado quando uma mensagem for recebida da fonte de dados.
Evento público StateChanged Evento que é gerado 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 ICloneable.Clone Cria uma nova instância do objeto de conexão que é uma cópia da instância atual.
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

Essa classe fornece uma comunicação básica com uma fonte de dados, recursos de suporte como conexões abertura e fechamento.Também fornece acesso a um conjunto de serviços que expõe funcionalidades mais específica na fonte de dados.

DDEX fornece a única implementação da classe; nenhum provedor de dados deve fornecer sua própria implementação da classe de DataConnection .Em vez de isso, os provedores de DDEX devem implementar a classe de DataConnectionSupport, que é empacotada na instância de DataConnection .

A vantagem de essa abordagem é que permite que DDEX fornece um recurso principal para o cliente e o provedor de dados: bloqueio de conexão para que os vários clientes podem compartilhar a mesma conexão no entanto não criar conflitos.Com essa arquitetura, os clientes não precisam se preocupar em conflito um com o outro, e os provedores de dados não precisa se preocupar com acesso com vários segmentos.

A classe de DataConnection obtém o nível de bloqueio servindo como um objeto de proxy para a instância de classe de DataConnectionSupport, além de fornecer objetos de proxy para cada serviço conhecido de DDEX disponível de conexão.Esses tipos proxies implementam cada método e propriedade bloqueando a conexão, chamar a implementação do provedor de dados, desbloqueando na conexão.

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

ICloneable

IDisposable