Classe DataProviderException

Rappresenta eccezione generata quando esiste un problema imprevisto con un provider di DDEX, come entità mancanti o non valide di supporto o di registrazione.

Gerarchia di ereditarietà

Object
  Exception
    Microsoft.VisualStudio.Data.Core.DataProviderException

Spazio dei nomi:  Microsoft.VisualStudio.Data.Core
Assembly:  Microsoft.VisualStudio.Data.Core (in Microsoft.VisualStudio.Data.Core.dll)

Sintassi

'Dichiarazione
<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

Il tipo DataProviderException espone i seguenti membri.

Costruttori

	Nome	Descrizione
	DataProviderException()	Inizializza una nuova istanza della classe DataProviderException.
	DataProviderException(String)	Inizializza una nuova istanza della classe DataProviderException, specificando un messaggio di errore.
	DataProviderException(SerializationInfo, StreamingContext)	Inizializza una nuova istanza della classe DataProviderException con dati serializzati.
	DataProviderException(String, Exception)	Inizializza una nuova istanza della classe DataProviderException, specificando un messaggio di errore e un riferimento all'eccezione interna che è la causa di questa eccezione.

In alto

Proprietà

	Nome	Descrizione
	Data	Ottiene una raccolta di coppie chiave-valore che fornisce informazioni aggiuntive definite dall'utente relative all'eccezione. (Ereditato da Exception)
	HelpLink	Ottiene o imposta un collegamento al file della Guida associato all'eccezione. (Ereditato da Exception)
	HResult	Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica. (Ereditato da Exception)
	InnerException	Ottiene l'istanza di Exception che ha causato l'eccezione corrente. (Ereditato da Exception)
	Message	Ottiene un messaggio che descrive l'eccezione corrente. (Ereditato da Exception)
	Source	Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore. (Ereditato da Exception)
	StackTrace	Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate. (Ereditato da Exception)
	TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)

In alto

Metodi

	Nome	Descrizione
	Equals	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
	Finalize	Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection. (Ereditato da Object)
	GetBaseException	Se usato come metodo di override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive. (Ereditato da Exception)
	GetHashCode	Funge da funzione hash predefinita. (Ereditato da Object)
	GetObjectData	Critico per la sicurezza. Quando l'override viene eseguito in una classe derivata, imposta il controllo SerializationInfo con le informazioni sull'eccezione. (Ereditato da Exception)
	GetType	Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception)
	MemberwiseClone	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
	ToString	Crea e restituisce una rappresentazione di stringa dell'eccezione corrente. (Ereditato da Exception)

In alto

Eventi

	Nome	Descrizione
	SerializeObjectState	Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione. (Ereditato da Exception)

In alto

Note

Questa eccezione viene generata quando la verifica iniziale della registrazione del provider di DDEX del servizio di gestione del provider di DDEX ha esito positivo, ma in ulteriore interrogazione si verifica erronea. Viene inoltre generata quando le entità principali di supporto come IVsDataConnectionProperties interfaccia, considerate base a un'implementazione del provider di DDEX, non viene trovato o non supportata.

Quando viene generata questa eccezione, un messaggio di errore generico viene visualizzato all'utente, indicando che esiste un problema nel provider di DDEX e che l'autore del provider dovrebbe possibile contattare. La descrizione completa di errore è collegato il log eventi di Windows.

Non è opportuno che i client o provider intercetti e gestire questa eccezione, a meno che non sia all'interno di un blocco catch generale che eventualmente rigenerazioni di un'eccezione o visualizzare il messaggio di errore in una finestra di messaggio.

DataProviderException utilizza il HRESULT E_UNEXPECTED, il cui valore 0x8000FFFF.

Esempi

Il codice seguente viene illustrata la creazione tentativo di un'entità di supporto di DDEX utilizzando un oggetto IVsDataProvider. Se l'entità di supporto non può essere creata, il codice visualizza una finestra di messaggio che contiene un errore.

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

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualStudio.Data.Core