Partager via


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
Méthode protégée DataProviderException() Initialise une nouvelle instance de la classe DataProviderException.
Méthode protégée DataProviderException(String) Initialise une nouvelle instance de la classe DataProviderException, en indiquant un message d'erreur.
Méthode protégée DataProviderException(SerializationInfo, StreamingContext) Initialise une nouvelle instance de la classe DataProviderException avec des données sérialisées.
Méthode protégée 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
Propriété publique 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.)
Propriété publique HelpLink Obtient ou définit un lien vers le fichier d'aide associé à cette exception. (Hérité de Exception.)
Propriété publique HResult Obtient ou définit HRESULT, valeur numérique codée qui est assignée à une exception spécifique. (Hérité de Exception.)
Propriété publique InnerException Obtient l'instance Exception qui a provoqué l'exception actuelle. (Hérité de Exception.)
Propriété publique Message Obtient un message qui décrit l'exception actuelle. (Hérité de Exception.)
Propriété publique 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.)
Propriété publique StackTrace Obtient une représentation sous forme de chaîne des frames immédiats sur la pile des appels. (Hérité de Exception.)
Propriété publique TargetSite Obtient la méthode qui lève l'exception actuelle. (Hérité de Exception.)

Début

Méthodes

  Nom Description
Méthode publique Equals Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégée 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.)
Méthode publique 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.)
Méthode publique GetHashCode Sert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publique 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.)
Méthode publique GetType Obtient le type au moment de l'exécution de l'instance actuelle. (Hérité de Exception.)
Méthode protégée MemberwiseClone Crée une copie superficielle du Object actuel. (Hérité de Object.)
Méthode publique ToString Crée et retourne une chaîne représentant l'exception actuelle. (Hérité de Exception.)

Début

Événements

  Nom Description
Événement protégé 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