Partilhar via


Interface IVsDataSourceManager

Representa o serviço do gerenciador de fonte de dados de DDEX, que permite a descoberta de fontes de dados registradas de DDEX.

Namespace:  Microsoft.VisualStudio.Data.Core
Assembly:  Microsoft.VisualStudio.Data.Core (em Microsoft.VisualStudio.Data.Core.dll)

Sintaxe

'Declaração
<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

O tipo IVsDataSourceManager expõe os membros a seguir.

Propriedades

  Nome Descrição
Propriedade pública Sources Obtém um dicionário de todas as fontes de dados registradas de DDEX.

Superior

Comentários

Provedores de DDEX registrar as fontes de dados que oferecem suporte para uma determinada instalação do Visual Studio adicionando chaves do Registro específicas na seção local de Registro do Visual Studio.O serviço do gerenciador de fonte de dados de DDEX enumera essas fontes de dados e fornece a lista de fontes de dados registrados para o chamador.Também executa o trabalho adicional para garantir que cada fonte de dados foi registrado corretamente.Informações sobre as fontes de dados que não são registradas corretamente entrada é o log de eventos do windows, e a fonte de dados não é retornada para o chamador.As seguintes características do registro são verificadas por esse serviço:

  • A chave de Registro da fonte de dados sob a chave de fontes de dados é válido que GUID consiste de 32 dígitos separados pelos hifens, entre colchetes ({}) xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

  • O valor do Registro de DefaultProvider, se especificado, é um GUID válido.

  • Todas as subchaves listadas na chave de SupportingProviders, se GUIDs são especificadas, válido.

  • Se um provedor padrão é especificado, será listado na chave de SupportingProviders.

  • Por o menos um dos provedores listados na chave de SupportingProviders é um provedor válido, registrado de DDEX.

Observe que determinadas edições do Visual Studio que restringem fontes de dados estão disponíveis.Por exemplo, as edições permitem apenas um subconjunto pequeno de fontes de dados do Microsoft DDEX.Essas restrições são para fins de negócios e substituem todas as entradas que pode ter sido adicionado além de essas fontes de dados que são permitidas edição.Um provedor de dado DDEX pode dinamicamente determinar se oferece suporte a fonte de dados no ambiente atual implementando a entidade de suporte de IVsDataProviderDynamicSupport .Se uma fonte de dados é determinada ser sem suporte a edição ou pelo ambiente atual, não é retornada por esse serviço.

O serviço do gerenciador de fonte de dados de DDEX é um serviço global do Visual Studio que está registrado com o ambiente.Portanto, você pode acessá-lo solicitando o serviço de um objeto global de provedor de serviços.

Exemplos

O código a seguir demonstra como um cliente pode recuperar o serviço do gerenciador de DDEX de um provedor de serviços global do Visual Studio e enumerar o conjunto de fontes de dados de DDEX registradas no ambiente.

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

Consulte também

Referência

Namespace Microsoft.VisualStudio.Data.Core