Share via

DataConnection (Clase)

  • Artículo

admite una conexión a un origen de datos.

Jerarquía de herencia

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

Espacio de nombres:  Microsoft.VisualStudio.Data
Ensamblado:  Microsoft.VisualStudio.Data (en Microsoft.VisualStudio.Data.dll)

Sintaxis

'Declaración
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

El tipo DataConnection expone los siguientes miembros.

Constructores

  Nombre Descripción
Método protegido DataConnection Constructor de clase.Crea una nueva instancia de la clase DataConnection.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública AsyncCommand Recupera un objeto que puede realizar la derivación asincrónica y la ejecución de comandos en el origen de datos.
Propiedad pública Command Recupera un objeto que puede realizar la derivación y la ejecución de comandos en el origen de datos.
Propiedad pública ConnectionSupport Recupera el objeto subyacente de la compatibilidad con la conexión del proveedor de datos que se utiliza para admitir la instancia actual de la conexión de datos.
Propiedad pública ConnectionTimeout Obtiene o establece la cantidad de tiempo, en segundos, antes de un comando para abrir tiempos de espera de una conexión.
Propiedad pública DisplayConnectionString Recupera o información de conexión sin cifrar de conjuntos en forma de cadena DDEX-proveedor- concreta.
Propiedad pública EncryptedConnectionString Recupera o conjuntos cifraron la información de conexión en forma de cadena DPAPI- cifrada, proveedor- concreta.
Propiedad pública IsLockedForExclusiveAccess Recupera un valor booleano que indica si la conexión actual está bloqueada por un cliente para el acceso exclusivo.
Propiedad pública ObjectChangeEvents Recupera un objeto que proporciona un conjunto de eventos provocados cuando los objetos de datos en el origen de datos se agregan, cambian, o se quitan.
Propiedad pública ObjectIdentifierConverter Recupera un objeto que puede convertir identificadores de objeto de datos de las cadenas con formato a elementos sin formato y viceversa.
Propiedad pública ObjectIdentifierResolver Recupera un objeto que pueda resolver los identificadores de objeto de datos con la extensión y la retractación.
Propiedad pública ObjectItemComparer Recupera un objeto que puede comparar elementos y propiedades de identificador en objetos de datos.
Propiedad pública ObjectSupport Recupera un objeto que proporciona una secuencia XML que define los diversos tipos de objeto de datos de DDEX admitidos por la conexión de datos actual.
Propiedad pública Provider Recupera el identificador único del proveedor de DDEX para la conexión de datos actual.
Propiedad pública ProviderObjectIsLocked Recupera un valor booleano que indica si el objeto de proveedor subyacente de DDEX está bloqueado para uso de un cliente.
Propiedad protegida ServiceTypes Recupera una lista de tipos de servicio utilizados para convertir la llamada al método no administrado de QueryService , en la que un servicio GUID se especifica, en una llamada al método administrado de IServiceProvider.GetService , en la que se especifica un tipo administrado. (Se hereda de ServiceProvider).
Propiedad pública Source Recupera el identificador único global (GUID) del origen de datos para la conexión de datos actual, si existe.
Propiedad pública SourceInformation Recupera un objeto que proporciona un conjunto de pares conocidos de nombre y valor que describen las características del origen de datos.
Propiedad pública SourceVersionComparer Recupera un objeto que permite comparar los números de versión dato-origen- concretos.
Propiedad pública State Recupera el estado actual de esta conexión de datos.
Propiedad pública Transaction Recupera un objeto que habilite procesamiento de transacciones; es decir, permite iniciar, confirmar, y revertir transacciones en el origen de datos.
Propiedad pública ViewSupport Recupera un objeto que proporciona una secuencia XML que define las distintas vistas de datos admitidas por la conexión de datos actual.

Arriba

Métodos

  Nombre Descripción
Método público Clone Crea una instancia clonada de esta conexión de datos, que conserva las mismas propiedades de conexión y estado que el original.
Método público Close Cierra la conexión de datos actual.
Método público Dispose() Elimina de la conexión de datos actual y de todos sus recursos asociados.
Método protegido Dispose(Boolean) Admite la infraestructura de DDEX y no está diseñado para usarse directamente desde el código.
Método público Equals Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método público EquivalentTo Recupera un valor booleano que indica si la información sobre la conexión actual es equivalente, en términos de tiempo de diseño, información de conexión especificada.
Método protegido Finalize Concluye la conexión. (Invalida a Object.Finalize()).
Método público GetExclusiveAccessProxy Recupera una instancia del proxy que deje a llamador acceso exclusivo a la conexión de datos.
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetLockedProviderObject() Recupera el objeto subyacente del proveedor de datos, si existe, que admite la conexión de datos actual.
Método público GetLockedProviderObject(Int32) Recupera el objeto subyacente del proveedor de datos, si existe, que admite la conexión de datos actual.
Método público GetService(Guid) Recupera un servicio con un servicio especificado GUID. (Se hereda de ServiceProvider).
Método público GetService(Type) Recupera un servicio del tipo especificado. (Se hereda de ServiceProvider).
Método protegido GetServiceImpl(Guid) Proporciona la implementación para recuperar un servicio con un GUID específico. (Se hereda de ServiceProvider).
Método protegido GetServiceImpl(Type) Proporciona la implementación para recuperar un servicio de un tipo específico. (Se hereda de ServiceProvider).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegido OnMessageReceived Controlador para el evento de MessageReceived .
Método protegido OnStateChanged Controlador para el evento de StateChanged .
Método público Open Abra esta conexión de datos.
Método público ReleaseExclusiveAccessProxy Publica un proxy exclusivo existente de acceso, suministrados con una llamada al método de GetExclusiveAccessProxy .
Método público ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).
Método público UnlockProviderObject Desbloquea un objeto de proveedor de DDEX que ha bloqueado mediante una llamada al método de GetLockedProviderObject.

Arriba

Eventos

  Nombre Descripción
Evento público MessageReceived Evento que se produce cuando se recibe un mensaje del origen de datos.
Evento público StateChanged Evento que se produce cuando el estado de la conexión de datos ha cambiado.

Arriba

Implementaciones explícitas de interfaces

  Nombre Descripción
Implementación explícita de interfacesMétodo privado ICloneable.Clone Crea una nueva instancia del objeto de conexión que es una copia de la instancia actual.
Implementación explícita de interfacesMétodo privado IServiceProvider.QueryService Realiza como generador para los servicios que se exponen con una implementación de IServiceProvider. (Se hereda de ServiceProvider).

Arriba

Comentarios

Esta clase proporciona la comunicación básica con un origen de datos, admiten funciones como abrir y conexiones cerradas.También proporciona acceso a un conjunto de servicios que exponen la funcionalidad más específica en el origen de datos.

DDEX proporciona la implementación única de esta clase; ningún proveedor de datos debe proporcionar su propia implementación de la clase de DataConnection .En su lugar, los proveedores de DDEX deben implementar la clase de DataConnectionSupport, que se ajusta por la instancia de DataConnection .

La ventaja de este enfoque es que permite que DDEX proporcione una característica clave al cliente y el proveedor de datos: bloqueo de la conexión para que varios clientes pueden compartir la misma conexión pero no crear conflictos.Con esta arquitectura, los clientes no tiene que ocuparse de estar en conflicto entre sí, y proveedores de datos no tiene que ocuparse de acceso multiproceso.

La clase de DataConnection alcanza este nivel de bloqueo sirviendo como objeto proxy para la instancia de clase de DataConnectionSupport, así como proporcionar los objetos proxy para cada servicio conocido de DDEX disponible de la conexión.Estos servidores proxy implementan cada método y propiedad bloqueando la conexión, llamar a la implementación del proveedor de datos, entonces desbloquear la conexión.

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

Microsoft.VisualStudio.Data (Espacio de nombres)

ICloneable

IDisposable