Compartilhar via

Classe DataProviderException

  • Artigo

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

System.Object
  System.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
Método protegido DataProviderException() Inicializa uma nova instância da classe DataProviderException.
Método protegido DataProviderException(String) Inicializa uma nova instância da classe de DataProviderException , especificando uma mensagem de erro.
Método protegido DataProviderException(SerializationInfo, StreamingContext) Inicializa uma nova instância da classe de DataProviderException com dados serializados.
Método protegido 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
Propriedade pública Data Obtém uma coleção de pares chave/valor que fornecem informações definido pelo usuário adicionais sobre a exceção. (Herdado de Exception.)
Propriedade pública HelpLink Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception.)
Propriedade protegida HResult Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica. (Herdado de Exception.)
Propriedade pública InnerException Obtém a instância Exception que causou a exceção atual. (Herdado de Exception.)
Propriedade pública Message Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception.)
Propriedade pública Source Obtém ou define o nome do aplicativo ou do objeto que faz com que o erro. (Herdado de Exception.)
Propriedade pública StackTrace Obtém uma representação de cadeia de caracteres dos quadros imediatos na pilha de chamadas. (Herdado de Exception.)
Propriedade pública TargetSite Obtém o método que lançou a exceção atual. (Herdado de Exception.)

Superior

Métodos

  Nome Descrição
Método público Equals determina se o objeto especificado é igual ao objeto atual. (Herdado de Object.)
Método protegido Finalize Permite que um objeto tentar liberar recursos e realizar outras operações de limpeza antes de ser recuperados pela coleta de lixo. (Herdado de Object.)
Método público GetBaseException Quando substituído em uma classe derivada, retorna Exception que é a raiz causa de uma ou mais exceções subseqüentes. (Herdado de Exception.)
Método público GetHashCode Serve como uma função de hash para um tipo específico. (Herdado de Object.)
Método público GetObjectData Quando substituído em uma classe derivada, define SerializationInfo com informações sobre a exceção. (Herdado de Exception.)
Método público GetType Obtém o tipo de tempo de execução da instância atual. (Herdado de Exception.)
Método protegido MemberwiseClone Cria uma cópia superficial de Objectatual. (Herdado de Object.)
Método público ToString Cria e retorna uma representação de cadeia de caracteres de exceção atual. (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