Compartir a través de

DataConnectionSupport (Clase)

  • Artículo

Proporciona las propiedades y métodos que permiten trabajar directamente con las conexiones a un origen de datos.

Jerarquía de herencia

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

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

Sintaxis

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

El tipo DataConnectionSupport expone los siguientes miembros.

Constructores

  Nombre Descripción
Método protegido DataConnectionSupport Inicializa una nueva instancia de la clase DataConnectionSupport.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública ConnectionString Obtiene o establece una representación de cadena de la información necesaria para establecer una conexión a un origen de datos especificada.
Propiedad pública ConnectionTimeout Obtiene o establece la cantidad de tiempo de espera al establecer una conexión antes de finalizar el intento y generar un error de tiempo de espera.
Propiedad protegida ParentProvider Obtiene la instancia actual del proveedor de servicios primario. (Se hereda de ServiceProvider).
Propiedad pública ProviderObject Obtiene el proveedor de datos subyacente, que admite la conexión de datos actual.
Propiedad protegida ServiceProvider Obtiene el proveedor de servicios global de Visual Studio .
Propiedad pública Site Obtiene o establece el sitio. (Se hereda de DataSiteableServiceProvider<T>).
Propiedad pública State Obtiene el estado de la conexión de datos.

Arriba

Métodos

  Nombre Descripción
Método público AddService(Type, ServiceCreatorCallback) Agrega el servicio especificado a la colección interna de servicios. (Se hereda de ServiceProvider).
Método público AddService(Type, Object) Agrega el servicio especificado a la colección interna de servicios. (Se hereda de ServiceProvider).
Método público AddService(Type, ServiceCreatorCallback, Boolean) Agrega el servicio especificado a la colección interna de servicios o el contenedor primario del servicio. (Se hereda de ServiceProvider).
Método público AddService(Type, Object, Boolean) Agrega el servicio especificado a la colección de objetos de servicio o el contenedor primario del servicio. (Se hereda de ServiceProvider).
Método público Close Cierra la conexión especificada.
Método protegido CreateService Crea un nuevo objeto de servicio, que especifica el tipo de la interfaz.
Método público Dispose() Libera todos los recursos retenidos por la conexión de datos.
Método protegido Dispose(Boolean) Libera todos los recursos retenidos por la conexión de datos.
Método público Equals Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegido Finalize Libera todos los recursos retenidos por la conexión de datos cuando se destruye el objeto de compatibilidad de la conexión de datos. (Invalida a Object.Finalize()).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
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 público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público Initialize Inicializa la conexión especificada, opcionalmente de un objeto de proveedor de los datos existentes.
Método protegido MemberwiseClone Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegido OnMessageReceived Controla el evento MessageReceived.
Método protegido OnSiteChanged Genera el evento SiteChanged. (Se hereda de DataSiteableServiceProvider<T>).
Método protegido OnStateChanged Controla el evento StateChanged.
Método público Open Abra la conexión de datos especificada.
Método público RemoveService(Type) Quita el servicio especificado de la colección interna de servicios (Se hereda de ServiceProvider).
Método público RemoveService(Type, Boolean) Quita el servicio especificado de la colección interna de los servicios o contenedor primario del servicio. (Se hereda de ServiceProvider).
Método público ToString Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Eventos

  Nombre Descripción
Evento público MessageReceived Se produce cuando se recibe un mensaje del origen de datos.
Evento público SiteChanged Se produce cuando el sitio ha cambiado. (Se hereda de DataSiteableServiceProvider<T>).
Evento público StateChanged 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 IServiceProvider.QueryService Realiza como generador para los servicios que se exponen con una implementación de IServiceProvider. (Se hereda de ServiceProvider).

Arriba

Comentarios

La clase de DataConnectionSupport representa la implementación del proveedor de datos para admitir una conexión de datos.

Las propiedades y los métodos de esta clase proporcionan la funcionalidad básica que permite al proveedor de datos se comunique con el origen de datos, realizando las tareas tales que apertura y conexiones cerradas y recuperar el estado de la conexión.Un proveedor de datos también puede exponer servicios especializados invalidando el método de CreateService .Los servicios conexión-relacionados actuales pueden ser resumidos como sigue:

  • IVsDataObjectSupport: Proporciona un método para recuperar XML que describen los tipos de objetos de datos admitidos por el origen de datos y las acciones que se pueden realizar en ellos.

  • IVsDataObjectIdentifierResolver: Proporciona un método para resolver identificadores de objeto de datos.

  • IVsDataObjectIdentifierConverter: Proporciona métodos para convertir la cadena y las representaciones de la matriz de identificadores de objeto de datos.

  • IVsDataObjectMemberComparer: Proporciona métodos para comparar elementos y valores de propiedad del identificador del objeto de datos.

  • IVsDataCommand: Proporciona la capacidad de derivar y ejecutar diferentes tipos de comandos.

  • IVsDataAsyncCommand: Permite ejecutar comandos de datos de forma asincrónica.

  • IVsDataTransaction: Proporciona la capacidad de iniciar, de confirmar, y de revertir transacciones posteriores.

  • IVsDataSourceVersionComparer: proporciona un método para comparar dos cadenas origen-específicas de la versión de los datos.

  • IVsDataSourceInformation: Proporciona un conjunto de pares bien definidos de nombre y valor que describen el origen de datos.

  • IVsDataMappedObjectConverter: Permisos que proporcionan un asignador personalizado de metadatos origen- específicos de los datos en conceptos conocidos que utilizará un diseñador genérico.

  • IVsDataObjectSelector: Habilita metadatos origen- específicos de datos sobre los objetos definidos en el archivo XML de la compatibilidad del objeto de datos.

  • IDSRefBuilder: Proporciona la capacidad de crear un objeto de (DSRef) de referencia de origen de datos que identifica uno o más objetos de datos.

Esta clase implementa la interfaz de IVsDataSiteableObject<T> , que permite que DDEX busque la implementación de DataConnectionSupport de un proveedor de datos con el objeto de IVsDataConnection que está llamando en ella.Esto proporciona la implementación con contexto, así como los medios para recuperar los servicios de Visual Studio .

Notas para los herederos

Cualquier clase derivada debe implementar las distintas propiedades y métodos abstractos para admitir la conexión.Una clase derivada también debe reemplazar el método protegido de CreateService para proporcionar la implementación de los servicios de la conexión.Cuando un provincia- cambio o un evento mensaje- recibido aparece, una clase derivada debe, cuando es posible, llamar al OnStateChanged y métodos protegidos de OnMessageReceived .

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.Framework (Espacio de nombres)