DataProviderException (Clase)

Representa la excepción que se produce cuando hay un problema inesperado con un proveedor de DDEX, como falta o registro no válido o admite las entidades.

Jerarquía de herencia

Object
  Exception
    Microsoft.VisualStudio.Data.Core.DataProviderException

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

Sintaxis

'Declaración
<SerializableAttribute> _
Public MustInherit Class DataProviderException _
    Inherits Exception

[SerializableAttribute]
public abstract class DataProviderException : Exception

[SerializableAttribute]
public ref class DataProviderException abstract : public Exception

[<AbstractClass>]
[<SerializableAttribute>]
type DataProviderException =  
    class 
        inherit Exception 
    end

public abstract class DataProviderException extends Exception

El tipo DataProviderException expone los siguientes miembros.

Constructores

	Nombre	Descripción
	DataProviderException()	Inicializa una nueva instancia de la clase DataProviderException.
	DataProviderException(String)	Inicializa una instancia nueva de la clase DataProviderException, especificando un mensaje de error.
	DataProviderException(SerializationInfo, StreamingContext)	Inicializa una nueva instancia de la clase DataProviderException con datos serializados.
	DataProviderException(String, Exception)	Inicializa una nueva instancia de la clase de DataProviderException , especificando un mensaje de error y una referencia a la excepción interna que es la causa de esta excepción.

Arriba

Propiedades

	Nombre	Descripción
	Data	Obtiene una colección de pares clave-valor que proporcionan más información definida por el usuario sobre la excepción. (Se hereda de Exception).
	HelpLink	Obtiene o establece un vínculo al archivo de ayuda asociado a esta excepción. (Se hereda de Exception).
	HResult	Obtiene o establece HRESULT, un valor numérico codificado que se asigna a una excepción específica. (Se hereda de Exception).
	InnerException	Obtiene la instancia Exception que produjo la excepción actual. (Se hereda de Exception).
	Message	Obtiene un mensaje que describe la excepción actual. (Se hereda de Exception).
	Source	Devuelve o establece el nombre de la aplicación o del objeto que generó el error. (Se hereda de Exception).
	StackTrace	Obtiene una representación de cadena de los marcos inmediatos en la pila de llamadas. (Se hereda de Exception).
	TargetSite	Obtiene el método que produjo la excepción actual. (Se hereda de Exception).

Arriba

Métodos

	Nombre	Descripción
	Equals	Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetBaseException	Cuando se invalida en una clase derivada, devuelve la clase Exception que representa la causa principal de una o más excepciones posteriores. (Se hereda de Exception).
	GetHashCode	Sirve como la función hash predeterminada. (Se hereda de Object).
	GetObjectData	Crítico para la seguridad. Cuando se invalida en una clase derivada, establece SerializationInfo con información sobre la excepción. (Se hereda de Exception).
	GetType	Obtiene el tipo en tiempo de ejecución de la instancia actual. (Se hereda de Exception).
	MemberwiseClone	Crea una copia superficial del Object actual. (Se hereda de Object).
	ToString	Crea y devuelve una representación de cadena de la excepción actual. (Se hereda de Exception).

Arriba

Eventos

	Nombre	Descripción
	SerializeObjectState	Ocurre cuando una excepción se serializa para crear un objeto de estado de excepción que contenga datos serializados sobre la excepción. (Se hereda de Exception).

Arriba

Comentarios

Esta excepción se produce cuando la comprobación inicial del registro del proveedor de DDEX por el servicio administrador de proveedor de DDEX es correcta, pero en la interrogación adicional se detecta como errónea. También se produce cuando no se encuentra o no se admiten a entidades admiten básicas como la interfaz de IVsDataConnectionProperties , que se consideran fundamentales en una implementación de proveedor de DDEX.

Cuando se produce esta excepción, un mensaje de error genérico se muestra al usuario, lo que indica que hay un problema en el proveedor de DDEX y que el programador de proveedores debe poner. La descripción de error completa se registra en el registro de eventos de Windows.

No se espera que los clientes o proveedores detectan y controlará esta excepción, a menos que esté dentro de un general catch bloqueado que finalmente los re- tiros o muestre el mensaje de error en un cuadro de mensaje.

DataProviderException utiliza HRESULT E_UNEXPECTED, que tiene el valor 0x8000FFFF.

Ejemplos

El código siguiente muestra la creación deseada de una entidad de soporte de DDEX utilizando un objeto de IVsDataProvider . Si la entidad admiten no puede crear, el código muestra un cuadro de mensaje que contiene un error.

using System;
using System.Windows.Forms;
using Microsoft.VisualStudio.Data.Core;
using Microsoft.VisualStudio.Data.Services.SupportEntities;

public class DdexExample
{
    public static IVsDataConnectionProperties CreateConnectionProperties(
        IVsDataProvider provider)
    {
        IVsDataConnectionProperties connProperties = null;
        try
        {
            connProperties = provider.CreateObject<IVsDataConnectionProperties>();
        }
        catch (DataProviderException e)
        {
            MessageBox.Show(e.Message);
        }
        return connProperties;
    }
}

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