Método IVsDataProvider.SupportsObject (Guid, Type)

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: Guid

  Um identificador de fonte de dados de DDEX, ou Empty para nenhuma fonte de dados específica.

• objType
  Tipo: Type

  Um tipo de entidade suporte de DDEX.

Valor de retorno

Tipo: 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 objType é nulluma referência nula (Nothing no Visual Basic).

Comentários

Para 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 verificar os recursos de um provedor determinado sem ter que 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 suportam um detalhe definido de entidades de suporte.

Um provedor de DDEX adicionar várias chaves do Registro sob uma chave de SupportedObjects em sua chave de Registro de raiz. Essas 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 estranho e 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 esse. Essas exceções incluem as entidades de suporte de IVsDataProviderDynamicSupport e de IVsDataSourceSpecializer , que prepended com o namespace de Microsoft.VisualStudio.Data.Corré.

Dica

DDEX no Visual Studio 2005 ler as chaves do Registro que identificam tipos de entidade de suporte no assembly 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 entidade antigo suporte de DataConnectionProperties.

Além dessas chaves do Registro entidade de suporte, um provedor de DDEX pode adicionar as subchaves em uma chave 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 está 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 suportada para somente as fontes de dados especificadas 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 de 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 entidade 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

• Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

IVsDataProvider Interface

Sobrecargas SupportsObject

Namespace Microsoft.VisualStudio.Data.Core