Classe DataProviderException

Representa a exceção que ocorre quando há um problema inesperado com um provedor de DDEX, como entidades ausente ou inválidos de registro ou de suporte.

Hierarquia de herança

Object
  Exception
    Microsoft.VisualStudio.Data.Core.DataProviderException

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

Sintaxe

'Declaração
<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

O tipo DataProviderException expõe os membros a seguir.

Construtores

	Nome	Descrição
	DataProviderException()	Inicializa uma nova instância da classe DataProviderException.
	DataProviderException(String)	Inicializa uma nova instância da classe de DataProviderException , especificando uma mensagem de erro.
	DataProviderException(SerializationInfo, StreamingContext)	Inicializa uma nova instância da classe de DataProviderException com dados serializados.
	DataProviderException(String, Exception)	Inicializa uma nova instância da classe de DataProviderException , especificando uma mensagem de erro e uma referência para a exceção interna que é a causa de essa exceção.

Superior

Propriedades

	Nome	Descrição
	Data	Gets a collection of key/value pairs that provide additional user-defined information about the exception. (Herdado de Exception.)
	HelpLink	Gets or sets a link to the help file associated with this exception. (Herdado de Exception.)
	HResult	Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception. (Herdado de Exception.)
	InnerException	Gets the Exception instance that caused the current exception. (Herdado de Exception.)
	Message	Gets a message that describes the current exception. (Herdado de Exception.)
	Source	Gets or sets the name of the application or the object that causes the error. (Herdado de Exception.)
	StackTrace	Gets a string representation of the immediate frames on the call stack. (Herdado de Exception.)
	TargetSite	Gets the method that throws the current exception. (Herdado de Exception.)

Superior

Métodos

	Nome	Descrição
	Equals	Determines whether the specified object is equal to the current object. (Herdado de Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Herdado de Object.)
	GetBaseException	When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions. (Herdado de Exception.)
	GetHashCode	Serves as the default hash function. (Herdado de Object.)
	GetObjectData	Segurança crítica. When overridden in a derived class, sets the SerializationInfo with information about the exception. (Herdado de Exception.)
	GetType	Gets the runtime type of the current instance. (Herdado de Exception.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Herdado de Object.)
	ToString	Creates and returns a string representation of the current exception. (Herdado de Exception.)

Superior

Eventos

	Nome	Descrição
	SerializeObjectState	Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception. (Herdado de Exception.)

Superior

Comentários

Esta exceção é lançada quando a verificação inicial do registro do provedor de DDEX pelo serviço do gerenciador do provedor de DDEX for bem-sucedida, mas uma interrogação adicional descobre-se para ser errado. Também é acionada quando as entidades de suporte principais como IVsDataConnectionProperties interface, que são consideradas fundamentais para uma implementação de provedor de DDEX, não é encontrado ou não é suportado.

Quando essa exceção é lançada, uma mensagem de erro genérica é mostrada para o usuário, indicando que há um problema no provedor de DDEX e que o gravador de provedor deve ser inserido em contato com. A descrição completa de erro é entrada o log de eventos do windows.

Não se espera que os clientes ou provedores capturarão e irá lidar com essa exceção, a menos que está dentro de um bloco gerais do catch que eventualmente os gera novamente ou exiba a mensagem de erro em uma caixa de mensagem.

DataProviderException usa HRESULT E_UNEXPECTED, que tem o valor 0x8000FFFF.

Exemplos

O código a seguir demonstra criando uma tentativa de entidade suporte de DDEX usando um objeto de IVsDataProvider . Se o objeto de suporte não pode ser criada, o código exibirá uma caixa de mensagem que contém um erro.

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;
    }
}

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.Core