IVsDataSourceManager (Interfaz)
Representa el servicio Administrador de orígenes de datos de DDEX, que habilita la detección de los orígenes de datos registrados de DDEX.
Espacio de nombres: Microsoft.VisualStudio.Data.Core
Ensamblado: Microsoft.VisualStudio.Data.Core (en Microsoft.VisualStudio.Data.Core.dll)
Sintaxis
'Declaración
<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
El tipo IVsDataSourceManager expone los siguientes miembros.
Propiedades
Nombre | Descripción | |
---|---|---|
Sources | Obtiene un diccionario de todos los orígenes de datos registrados de DDEX. |
Arriba
Comentarios
Los proveedores de DDEX registrar los orígenes de datos que admiten para una instalación determinada de Visual Studio agregando clave del Registro concretos en el subárbol local del registro de Visual Studio. El servicio Administrador de orígenes de datos de DDEX enumera estos orígenes de datos y proporcione la lista de orígenes de datos registrados al llamador. También realiza un trabajo adicional para asegurarse de que cada origen de datos está registrada correctamente. La información sobre los orígenes de datos que no se registran correctamente se registra en el registro de eventos de Windows, y el origen de datos no se vuelve al llamador. Las características siguientes de registro son comprobadas por este servicio:
La clave del Registro del origen de datos en la clave de DataSources es un GUID válido que consta de 32 dígitos separados por guiones, entre corchetes ({xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}).
El valor de Registro DefaultProvider, si se especifica, es un GUID válido.
Las subclaves enumeradas bajo la clave de SupportingProviders, si están especificadas, son todas GUID válido.
Si se especifica un proveedor predeterminado, se muestra bajo la clave de SupportingProviders.
Al menos uno de los proveedores enumerados en la clave de SupportingProviders es un proveedor válido, registrado de DDEX.
Observe que ciertas ediciones de Visual Studio restringen los orígenes de datos disponibles. Por ejemplo, las ediciones Express sólo permiten un pequeño subconjunto de los orígenes de datos de Microsoft DDEX. Estas restricciones se usan con fines empresariales y reemplaza cualquier entrada que pueda haber agregado además de esos orígenes de datos permitidas por la edición. Un proveedor determinado de DDEX puede determinar dinámicamente si admite el origen de datos en un entorno actual implementando la entidad de compatibilidad de IVsDataProviderDynamicSupport . Si un origen de datos resulta especialmente para estar no compatible con editar o el entorno actual, no es devuelto por este servicio.
El servicio Administrador de orígenes de datos de DDEX es un servicio global de Visual Studio que se registra con el entorno. Por consiguiente, puede tener acceso solicita el servicio de un objeto global del proveedor de servicios.
Ejemplos
El código siguiente muestra cómo un cliente puede recuperar el servicio en el Administrador de orígenes de DDEX de un proveedor de servicios global de Visual Studio y mostrar el conjunto de orígenes de datos de DDEX registrados en el entorno.
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);
}
}
}