Partager via


IVsDataSourceManager, interface

Représente le service du gestionnaire de source de données de DDEX, qui active la découverte des sources de données stockées de DDEX.

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

Syntaxe

'Déclaration
<GuidAttribute("32E0C769-C2C9-4587-B58C-013266137571")> _
Public Interface IVsDataSourceManager
[GuidAttribute("32E0C769-C2C9-4587-B58C-013266137571")]
public interface IVsDataSourceManager
[GuidAttribute(L"32E0C769-C2C9-4587-B58C-013266137571")]
public interface class IVsDataSourceManager
[<GuidAttribute("32E0C769-C2C9-4587-B58C-013266137571")>]
type IVsDataSourceManager =  interface end
public interface IVsDataSourceManager

Le type IVsDataSourceManager expose les membres suivants.

Propriétés

  Nom Description
Propriété publique Sources Obtient un dictionnaire de toutes les sources de données stockées de DDEX.

Début

Notes

Les fournisseurs de DDEX stockent les sources de données qu'ils prennent en charge pour une configuration spécifique de Visual Studio en ajoutant les clés de Registre spécifiques dans la ruche locale de Registre de Visual Studio. Le service du gestionnaire de source de données de DDEX énumère les sources de données et fournit la liste des sources de données stockées à l'appelant. Il effectue également le travail supplémentaire pour garantir que chaque source de données est enregistrée correctement. Les informations sur les sources de données qui ne sont pas stockées correctement sont ouvertes une session le journal des événements Windows, et la source de données ne sont pas retourné à l'appelant. Les caractéristiques suivantes d'inscription sont vérifiées par ce service :

  • La clé de Registre de source de données sous la clé de sources de données est un GUID valide composé de 32 chiffres séparés par des traits d'union, entre parenthèses ({xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}).

  • La valeur de Registre de DefaultProvider, si spécifiée, est un GUID valide.

  • Toutes les sous-clés répertoriées sous la clé de SupportingProviders, si spécifiées, sont GUID valide.

  • Si un fournisseur par défaut est spécifié, il est répertorié sous la clé de SupportingProviders.

  • Au moins l'un des fournisseurs répertoriés sous la clé de SupportingProviders est un fournisseur valide et stocké de DDEX.

Notez que certaines éditions de Visual Studio restreignent les sources de données disponibles. Par exemple, les éditions Express autorisent uniquement un sous-ensemble des sources de données Microsoft DDEX. Ces restrictions sont à des fins commerciales et remplacer toutes les entrées qui ont peut-être été ajoutées en plus de ces sources de données qui sont autorisées par l'édition. Un fournisseur donné de DDEX dynamique peut déterminer s'il prend en charge la source de données dans l'environnement actuel en implémentant l'entité de prise en charge d' IVsDataProviderDynamicSupport . Si une source de données est déterminée comme étant non prise en charge par l'édition ou l'environnement actif, elle n'est pas retournée par ce service.

Le service du gestionnaire de source de données de DDEX est un service global de Visual Studio qui est stocké avec l'environnement. Par conséquent, vous pouvez y accéder en indiquant le service d'un objet global du fournisseur de services.

Exemples

Le code suivant montre comment un client peut extraire le service du gestionnaire de source de DDEX d'un fournisseur de services global de Visual Studio et énumérer un ensemble de sources de données de DDEX stockées dans l'environnement.

using System;
using System.Diagnostics;
using Microsoft.VisualStudio.Data.Core;

public class DDEX_IVsDataSourceManagerExample1
{
    public static void EnumerateDataSources(IServiceProvider serviceProvider)
    {
        IVsDataSourceManager sourceManager =
            serviceProvider.GetService(typeof(IVsDataSourceManager))
                as IVsDataSourceManager;
        foreach (IVsDataSource source in sourceManager.Sources.Values)
        {
            Trace.WriteLine(source.DisplayName);
        }
    }
}

Voir aussi

Référence

Microsoft.VisualStudio.Data.Core, espace de noms