Compartir a través de

IVsDataProvider.SupportsObject (Método) (Guid, Type)

  • Artículo

确定 DDEX 提供程序是否支持 DDEX 指定的 DDEX 数据源中实体支持指定的类型。

Espacio de nombres:  Microsoft.VisualStudio.Data.Core
Ensamblado:  Microsoft.VisualStudio.Data.Core (en Microsoft.VisualStudio.Data.Core.dll)

Sintaxis

'Declaración
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

    一 DDEX 标识符或 Empty 数据源没有特定数据源。

  • objType
    Tipo: Type

    DDEX 支持实体的类型。

Valor devuelto

Tipo: Boolean
true ，如果 DDEX 提供程序支持 DDEX 指定的 DDEX 数据源中实体支持指定的类型；否则，返回 false。

Excepciones

Excepción Condición
ArgumentNullException

objType 参数为 nullreferencia null (Nothing en Visual Basic)。

Comentarios

确定 DDEX 提供程序是否支持指定的 DDEX 支持基于实体添加到注册表。DDEX 提供程序的信息。 这使客户 DDEX 检查特定提供程序的功能，而无需加载所有提供程序代码。 这十分有用，如果您通过一组提供程序确定循环访问支持一组特定实体支持提供程序中的已筛选的列表。

DDEX 提供程序添加各个注册表项。SupportedObjects 键下在其根注册表项下。 这些键提供的实体支持的每种类型名称支持。 名称必须是一个非空字符串，因此不会有额外的前导或尾随空白，因此必须表示实体支持的可展开或完全限定的类型名。 可扩展的 支持实体 是扩展为完全限定的类型名称 Microsoft.VisualStudio.Data.Services.SupportEntities 通过预置命名空间的非限定的类型名称。 具有一些特定异常到这一点。 这些包含异常 IVsDataProviderDynamicSupport 和 IVsDataSourceSpecializer 支持实体，前预置 Microsoft.VisualStudio.Data.Core 命名空间。

Nota

在 Visual Studio 2005 中 DDEX 读取以确定 Microsoft.VisualStudio.Data 程序集支持的实体类型的注册表项。在 Visual Studio 2008 中 DDEX 仍将兼容性目的这些注册表项并支持实体映射旧类型为新的。例如，如果提供程序注册，旧 DataConnectionProperties 支持实体类型，对 SupportsObject 方法的调用使用 IVsDataConnectionProperties 类型的 Visual Studio 2005 DDEX 提供程序将返回 true。

除了这些支持实体注册表项之外，DDEX 提供程序可以添加表示特定 DDEX 数据源支持实体支持的子项。特定支持实体项下。 如果这些子项不存在，支持实体假定为所有 DDEX 数据源支持。 如果一个或多个子项，存在支持实体假定只指定的 DDEX 数据源支持。 除特定 DDEX 数据源，实现外如果支持实体具有未指定的 DDEX 数据源的标准实现，则必须存在具有 null GUID 的子项。 必须还有特定 DDEX 数据源的键。 如果任何子项不是有效的 GUID，则忽略。

如果指定的支持实体类型定义具有默认实现，此方法始终返回 true。

Ejemplos

下面的代码演示了如何确定指定的 DDEX 提供程序是否支持连接的方法为指定数据源连接在 UI 中。

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

Seguridad de .NET Framework

Vea también

Referencia

IVsDataProvider Interfaz

SupportsObject (Sobrecarga)

Microsoft.VisualStudio.Data.Core (Espacio de nombres)