IVsDataSourceManager-Schnittstelle
Stellt den DDEX-Datenquellen-Managerdienst, der Suche von registrierten DDEX-Datenquellen aktiviert.
Namespace: Microsoft.VisualStudio.Data.Core
Assembly: Microsoft.VisualStudio.Data.Core (in Microsoft.VisualStudio.Data.Core.dll)
Syntax
'Declaration
<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
Der IVsDataSourceManager-Typ macht die folgenden Member verfügbar.
Eigenschaften
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliche Eigenschaft") |
Sources | Ruft ein Wörterbuch aller registrierten DDEX-Datenquellen ab. |
Zum Seitenanfang
Hinweise
DDEX-Anbieter registrieren die Datenquellen, die sie für eine bestimmte Installation von Visual Studio unterstützen, können Sie bestimmte Registrierungsschlüssel in den Registrierungshive der Visual Studio-lokalenVariable hinzufügen. Der DDEX-Datenquellen-Managerdienst listet diese Datenquellen auf und stellt die Liste der registrierten Datenquellen an den Aufrufer. Sie führt auch zusätzliche Aufgaben aus, um sicherzustellen, dass jede Datenquelle ordnungsgemäß registriert ist. Informationen über Datenquellen, die nicht ordnungsgemäß registriert werden, werden dem Windows-Ereignisprotokoll und die Datenquelle zurückgegeben werden nicht an den Aufrufer angemeldet. Die folgenden Registrierungseigenschaften werden von diesem Dienst überprüft:
Der Datenquellenregistrierungsschlüssel unter der Datenquellentaste ist ein gültiges GUID, die aus 32 Ziffern besteht, die durch den Bindestriche getrennt werden, eingeschlossen in Klammern ({}) Format.
Der DefaultProvider-Registrierungswert, wenn er angegeben wird, ist ein gültiges GUID.
Alle Unterschlüssel, die unter der SupportingProviders-aufgeführt werden Schlüssel, wenn sie angegeben werden, sind gültige GUID.
Wenn ein Standardanbieter angegeben wird, wird er unter der SupportingProviders-Taste aufgeführt.
Es ist mindestens einer der Anbieter, die unter der SupportingProviders-Taste aufgeführt sind, ein gültiger, registrierter DDEX-Anbieter.
Beachten Sie, dass bestimmte Editionen von Visual Studio einschränken, welche Datenquellen verfügbar sind. Beispielsweise ermöglichen die Express nur eine kleine Teilmenge der Datenquellen Microsoft DDEX. Diese Einschränkungen werden für geschäftliche Zwecke und überschreiben alle Einträge, die möglicherweise zusätzlich zu diesen Datenquellen hinzugefügt, die durch die Edition zugelassen werden. Ein angegebener DDEX-Anbieter dynamisch bestimmt, ob die Datenquelle unter die aktuelle Umgebung unterstützt, indem die IVsDataProviderDynamicSupport Stützentität implementiert. Wenn eine Datenquelle bestimmt wird, um nicht unterstützt werden durch die Edition oder die aktuelle Umgebung, wird sie nicht von diesem Dienst zurückgegeben.
Der DDEX-Datenquellen-Managerdienst ist ein globaler Visual Studio-Dienst, der der Umgebung registriert wird. Daher können Sie darauf zugreifen, indem Sie den Dienst aus einem globalen Dienstanbieterobjekt anfordern.
Beispiele
Der folgende Code zeigt, wie ein Client den DDEX-Quellmanagerdienst aus einem globalen Visual Studio-Dienstanbieter abrufen und von DDEX-Datenquellen aufgelistet werden können, die in der Umgebung registriert werden.
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);
}
}
}