IVsDataSourceManager インターフェイス

登録された DDEX のデータ ソースを検出できるようにする DDEX のデータ ソースのマネージャーでサービスを表すします。

名前空間:  Microsoft.VisualStudio.Data.Core
アセンブリ:  Microsoft.VisualStudio.Data.Core (Microsoft.VisualStudio.Data.Core.dll 内)

構文

'宣言
<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

IVsDataSourceManager 型で公開されるメンバーは以下のとおりです。

プロパティ

  名前 説明
パブリック プロパティ Sources 登録されたすべての DDEX のデータ ソースのディクショナリを取得します。

このページのトップへ

解説

DDEX プロバイダーは、Visual Studio の特定のインストールについては、Visual Studio のローカルなレジストリ ハイブの特定のレジストリ キーを追加することで、サポートするデータ ソースを登録します。DDEX のデータ ソースのマネージャー サービスは、これらのデータ ソースを列挙し、呼び出し元に登録されたデータ ソースの一覧を指定します。また、各データ ソースが正しく登録されていることを確認するために、追加の処理を実行します。正しく登録されていないデータ ソースに関する情報は呼び出し元に Windows イベント ログおよびデータ ソースは戻りません記録されます。次の登録の特性は、このサービスによって検証されます:

  • データ ソースのキーの下のデータ ソースのレジストリ キーはかっこで囲まれているハイフンで区切る 32 桁で構成される、有効な GUID です ({xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx})。

  • DefaultProvider のレジストリ値は、指定されている場合、有効な GUID です。

  • SupportingProviders キーの下にあるサブキーを指定すると、すべて有効な GUID です。

  • 既定のプロバイダーを指定した場合、SupportingProviders キーの下に表示されます。

  • SupportingProviders キーの下に表示されるプロバイダーのうち少なくとも 1 つが、有効な登録済み DDEX プロバイダーです。

ようにデータ ソースが使用できる Visual Studio の restrict の一部のエディション注意してください。たとえば、Express Edition では、Microsoft DDEX のデータ ソースの小さなサブセットのみを許可します。これらの制限があり目的で、エディションによって許可されるデータ ソースに追加される可能性があるエントリをオーバーライドします。特定の DDEX プロバイダーは動的に現在の環境で IVsDataProviderDynamicSupport のサポートのエンティティを実行してデータ ソースをサポートするかどうかを判断することがあります。データ ソースが Edition または現在の環境によってサポートされていないために設定されている場合、このサービスによっては返されません。

DDEX のデータ ソースのマネージャー サービスは環境に登録されているグローバル Visual Studio のサービスです。したがって、グローバル サービス プロバイダーからオブジェクトのサービス要求でアクセスできます。

例

次のコードは、クライアントが Visual Studio のグローバル サービス プロバイダーから DDEX の情報の文献管理サービスを取得し、環境に登録されている DDEX のデータ ソースのセットを列挙できるかを示します。

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

参照

関連項目

Microsoft.VisualStudio.Data.Core 名前空間

  • Last updated on