DataProviderException, classe

Représente l'exception qui se produit en cas de problème inattendu avec un fournisseur de DDEX, tel que manquant ou les entités valides d'inscription ou de charge.

Hiérarchie d'héritage

Object
  Exception
    Microsoft.VisualStudio.Data.Core.DataProviderException

Espace de noms :  Microsoft.VisualStudio.Data.Core
Assembly :  Microsoft.VisualStudio.Data.Core (dans Microsoft.VisualStudio.Data.Core.dll)

Syntaxe

'Déclaration
<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

Le type DataProviderException expose les membres suivants.

Constructeurs

	Nom	Description
	DataProviderException()	Initialise une nouvelle instance de la classe DataProviderException.
	DataProviderException(String)	Initialise une nouvelle instance de la classe DataProviderException, en indiquant un message d'erreur.
	DataProviderException(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la classe DataProviderException avec des données sérialisées.
	DataProviderException(String, Exception)	Initialise une nouvelle instance de la classe d' DataProviderException , en spécifiant un message d'erreur et une référence à l'exception interne qui est la cause de cette exception.

Début

Propriétés

	Nom	Description
	Data	Obtient une collection de paires clé/valeur qui fournissent des informations supplémentaires définies par l'utilisateur sur l'exception. (Hérité de Exception.)
	HelpLink	Obtient ou définit un lien vers le fichier d'aide associé à cette exception. (Hérité de Exception.)
	HResult	Obtient ou définit HRESULT, valeur numérique codée qui est assignée à une exception spécifique. (Hérité de Exception.)
	InnerException	Obtient l'instance Exception qui a provoqué l'exception actuelle. (Hérité de Exception.)
	Message	Obtient un message qui décrit l'exception actuelle. (Hérité de Exception.)
	Source	Obtient ou définit le nom de l'application ou de l'objet qui est à l'origine de l'erreur. (Hérité de Exception.)
	StackTrace	Obtient une représentation sous forme de chaîne des frames immédiats sur la pile des appels. (Hérité de Exception.)
	TargetSite	Obtient la méthode qui lève l'exception actuelle. (Hérité de Exception.)

Début

Méthodes

	Nom	Description
	Equals	Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
	Finalize	Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection. (Hérité de Object.)
	GetBaseException	En cas de substitution dans une classe dérivée, retourne Exception qui est à l'origine d'une ou de plusieurs exceptions suivantes. (Hérité de Exception.)
	GetHashCode	Sert de fonction de hachage par défaut. (Hérité de Object.)
	GetObjectData	Essentiel pour la sécurité. En cas de substitution dans une classe dérivée, définit SerializationInfo avec des informations sur l'exception. (Hérité de Exception.)
	GetType	Obtient le type au moment de l'exécution de l'instance actuelle. (Hérité de Exception.)
	MemberwiseClone	Crée une copie superficielle du Object actuel. (Hérité de Object.)
	ToString	Crée et retourne une chaîne représentant l'exception actuelle. (Hérité de Exception.)

Début

Événements

	Nom	Description
	SerializeObjectState	Se produit quand une exception est sérialisée pour créer un objet d'état d'exception qui contient des données sérialisées concernant l'exception. (Hérité de Exception.)

Début

Notes

Cette exception est levée lorsque la vérification initiale de l'inscription de fournisseur de DDEX par le service du gestionnaire de fournisseur de DDEX réussit, mais d'autres d'interrogation on découvre comme étant erroné. Il est également levée si principal prennent en charge les entités telles que l'interface d' IVsDataConnectionProperties , qui sont considérées comme fondamentales à une implémentation de fournisseur de DDEX, est introuvable ou pris en charge.

Lorsque cette exception est levée, un message d'erreur générique s'affiche à l'utilisateur, indiquant qu'il existe un problème dans le fournisseur de DDEX et que le writer de fournisseur doit être contacté. La description complète d'erreur est ouvert une session le journal des événements Windows.

Il n'attend pas que les clients ou les fournisseurs interceptent et gèreront cette exception, à moins qu'il soit dans un bloc de catch général que par la suite les nouveau lève ou affiche le message d'erreur dans un message.

DataProviderException utilise le HRESULT E_UNEXPECTED, qui a la valeur 0x8000FFFF.

Exemples

Le code suivant illustre la création d'une tentative d'une entité de prise en charge DDEX à l'aide d'un objet d' IVsDataProvider . Si l'entité de charge ne peut pas être créée, le code affiche un message contenant une erreur.

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

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Microsoft.VisualStudio.Data.Core, espace de noms