Compartilhar via

Método IVsDataProvider.SupportsObject (Guid, Type)

  • Artigo

Determina se um provedor de DDEX suporta o tipo especificado de entidade suporte de DDEX para a fonte de dados especificada de DDEX.

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

Sintaxe

'Declaração
Function SupportsObject ( _
    source As Guid, _
    objType As Type _
) As Boolean

bool SupportsObject(
    Guid source,
    Type objType
)

bool SupportsObject(
    Guid source, 
    Type^ objType
)

abstract SupportsObject : 
        source:Guid * 
        objType:Type -> bool 

function SupportsObject(
    source : Guid, 
    objType : Type
) : boolean

Parâmetros

  • source
    Tipo: System.Guid
    Um identificador de fonte de dados de DDEX, ou Empty para nenhuma fonte de dados específica.
  • objType
    Tipo: System.Type
    Um tipo de entidade suporte de DDEX.

Valor de retorno

Tipo: System.Boolean
true se o provedor de DDEX suporta o tipo especificado de entidade suporte de DDEX para a fonte de dados especificada de DDEX; caso contrário, false.

Exceções

Exceção Condição
ArgumentNullException

o parâmetro de objType é nulluma referência nula (Nothing no Visual Basic).

Comentários

Como determinar se um provedor de DDEX suporta uma entidade especificada de suporte de DDEX é baseada na informação que é adicionada ao Registro pelo provedor de DDEX.Isso permite que clientes de DDEX para inspecionar os recursos de um provedor determinado sem precisar carregar qualquer código de provedor.Isso é útil quando você está iterando através do conjunto de provedores para determinar uma lista filtrada de provedores que oferecem suporte a um determinado definido de entidades de suporte.

Um provedor de DDEX adicionar várias chaves do Registro em uma chave de SupportedObjects sob a chave de Registro de raiz.As chaves fornecem os nomes de cada tipo de entidade de suporte que é suportada.O nome da chave deve ser uma cadeia de caracteres não vazio sem nenhum espaço em branco à esquerda ou à direita e estranho deve representar expansível ou um nome de tipo totalmente qualificado de um entidade de suporte.Uma entidade expansível de suporte não é um nome qualificado do tipo que é expandido para um nome de tipo totalmente qualificado prepending o namespace de Microsoft.VisualStudio.Data.Services.SupportEntities.Há algumas exceções especiais a este.Essas exceções incluem as entidades de suporte de IVsDataProviderDynamicSupport e de IVsDataSourceSpecializer , que prepended com o namespace de Microsoft.VisualStudio.Data.Core.

ObservaçãoObservação

DDEX no Visual Studio 2005 ler as chaves do Registro que identificam o suporte que a principal no conjunto de Microsoft.VisualStudio.Data.DDEX no Visual Studio 2008 ainda ler as chaves do Registro para fins de compatibilidade e mapeia os tipos de entidade antigos de suporte em novos.Por exemplo, uma chamada para o método de SupportsObject para um provedor do Visual Studio 2005 DDEX com o tipo de IVsDataConnectionProperties retornará true se o provedor registrou o tipo de objeto antigo suporte de DataConnectionProperties.

Além de essas chaves do Registro entidade de suporte, um provedor de DDEX pode adicionar as subchaves chave em uma determinada entidade de suporte que representam as fontes de dados específicas de DDEX para a entidade de suporte é suportada.Se nenhuma uma subchave existir, a entidade de suporte será assumida para ser suportada para todas as fontes de dados de DDEX.Se uma ou mais subchaves, existem a entidade de suporte será assumida para ser suportado apenas para as fontes de dados especificado de DDEX.Se uma entidade de suporte tem uma implementação padrão de fontes de dados não específicas de DDEX além das implementações de fontes de dados específicas de DDEX, deve haver uma subchave pelo GUID vazia.Também deve haver subchaves para fontes de dados específicas de DDEX.Se nenhuma subchave não é válido GUID, será ignorada.

Se o tipo de objeto especificado de suporte é definido para ter uma implementação padrão, esse método sempre retorna true.

Exemplos

O código a seguir demonstra como identificar se um provedor especificado de DDEX suporta um método para se conectar a uma fonte de dados especificada no contexto de uma conexão interface do usuário.

using System;
using Microsoft.VisualStudio.Data.Core;
using Microsoft.VisualStudio.Data.Services.SupportEntities;

public class DDEX_IVsDataProviderExample9
{
    public static bool HasSpecialConnectForUI(
        IVsDataProvider provider, Guid source)
    {
        return provider.SupportsObject(
            source, typeof(IVsDataConnectionUIConnector));
    }
}

Segurança do .NET Framework

Consulte também

Referência

IVsDataProvider Interface

Sobrecargas SupportsObject

Namespace Microsoft.VisualStudio.Data.Core