Partager via

IVsDataProvider.SupportsObject, méthode (Guid, Type)

  • Article

Détermine si un fournisseur de DDEX prend en charge le type spécifié d'entité de support de DDEX pour la source de données spécifiée de DDEX.

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

Syntaxe

'Déclaration
Function SupportsObject ( _
    source As Guid, _
    objType As Type _
) As Boolean

bool SupportsObject(
    Guid source,
    Type objType
)

bool SupportsObject(
    Guid source, 
    Type^ objType
)

abstract SupportsObject : 
        source:Guid * 
        objType:Type -> bool

function SupportsObject(
    source : Guid, 
    objType : Type
) : boolean

Paramètres

  • source
    Type : Guid

    Identificateur de source de données de DDEX, ou Empty pour aucune source de données spécifique.

  • objType
    Type : Type

    Un type d'entité de support de DDEX.

Valeur de retour

Type : Boolean
true si le fournisseur de DDEX prend en charge le type spécifié d'entité de support de DDEX pour la source de données spécifiée de DDEX ; sinon, false.

Exceptions

Exception Condition
ArgumentNullException

Le paramètre objType est nullune référence null (Nothing en Visual Basic).

Notes

Vous pouvez déterminer si un fournisseur de DDEX prend en charge une entité spécifiée de support de DDEX dépend des informations ajoutées au Registre par le fournisseur de DDEX. Cela permet aux clients de DDEX pour inspecter les fonctions d'un fournisseur donné sans devoir charger tout code de fournisseur. Cela est utile lorsque vous itérez au sein de l'ensemble de fournisseurs pour déterminer une liste filtrée de fournisseurs qui prennent en charge un ensemble d'entités Support.

Un fournisseur de DDEX ajoute plusieurs clés de Registre dans une clé de SupportedObjects sous leur clé de Registre de la racine. Ces touches fournissent les noms de chaque type d'entité de média pris en charge. Nom de la clé doit être une chaîne non vide sans espaces blancs de début ou de fin étranger et doit représenter un nom extensible ou de type qualifié complet d'une entité de média. Une entité extensible de média est un nom non qualifiée de type développé à un nom de type qualifié complet en ajoutant l'espace de noms Microsoft.VisualStudio.Data.Services.SupportEntities. Il existe quelques exceptions particulières comme suit. Ces exceptions incluent des entités de média d'IVsDataProviderDynamicSupport et IVsDataSourceSpecializer, qui sont ajoutées à l'espace de noms de Microsoft.VisualStudio.Data.Core.

Notes

DDEX dans Visual Studio 2005 lit les clés de Registre qui identifient les types d'entité de liaison dans l'assembly de Microsoft.VisualStudio.Data.DDEX dans Visual Studio 2008 lit ces clés de Registre pour la compatibilité et mappe toujours les types d'entité anciens de médias aux nouvelles.Par exemple, un appel à la méthode SupportsObject pour un fournisseur de Visual Studio 2005 DDEX avec le type IVsDataConnectionProperties retourne true si le fournisseur est le type d'entité ancien de support de DataConnectionProperties.

Outre ces clés de Registre d'entité de média, un fournisseur de DDEX peut ajouter les sous-clés sous une clé données d'entité de support qui représentent les sources de données spécifiques de DDEX pour lesquelles l'entité de média est prise en charge. Si telle sous-clé n'existe pas, il est supposé que l'entité de média est prise en charge pour toutes les sources de données de DDEX. Si un ou plusieurs sous-clés existent, il est supposé que l'entité de média est prise en charge uniquement pour les sources de données spécifiées de DDEX. Si une entité de média possède une implémentation standard pour les sources de données non spécifiques de DDEX en plus des implémentations pour les sources de données spécifiques de DDEX, il doit exister une sous-clé avec un GUID vide. Il doit également exister des sous-clés pour les sources de données spécifiques de DDEX. Si aucune sous-clé n'est un GUID valide, elle est ignorée.

Si le type d'entité spécifié de média est défini pour avoir une implémentation par défaut, cette méthode retourne toujours true.

Exemples

Le code suivant montre comment déterminer si un fournisseur spécifié de DDEX prend en charge une méthode pour se connecter à une source de données spécifiée dans le contexte d'une interface utilisateur de connexion.

using System;
using Microsoft.VisualStudio.Data.Core;
using Microsoft.VisualStudio.Data.Services.SupportEntities;

public class DDEX_IVsDataProviderExample9
{
    public static bool HasSpecialConnectForUI(
        IVsDataProvider provider, Guid source)
    {
        return provider.SupportsObject(
            source, typeof(IVsDataConnectionUIConnector));
    }
}

Sécurité .NET Framework

Voir aussi

Référence

IVsDataProvider Interface

SupportsObject, surcharge

Microsoft.VisualStudio.Data.Core, espace de noms