Поделиться через

IVsDataProvider.SupportsObject - метод (Guid, Type)

  • Статья

Определяет, поддерживает ли поставщик DDEX указанный тип сущности поддержки DDEX для конкретного источника данных DDEX.

Пространство имен:  Microsoft.VisualStudio.Data.Core
Сборка:  Microsoft.VisualStudio.Data.Core (в Microsoft.VisualStudio.Data.Core.dll)

Синтаксис

'Декларация
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

Параметры

  • source
    Тип: Guid

    Идентификатор источника данных DDEX или Empty для каких-либо конкретного источника данных.

  • objType
    Тип: Type

    Тип сущности поддержки DDEX.

Возвращаемое значение

Тип: Boolean
true , если поставщик поддерживает DDEX указанный тип сущности поддержки DDEX для конкретного источника данных DDEX; в противном случае false.

Исключения

Исключение Условие
ArgumentNullException

Значение параметра objType — nullссылка NULL (Nothing в Visual Basic).

Заметки

Определение, поддерживает ли поставщик DDEX определенную сущность поддержки DDEX основывается на сведениях, добавляются в реестр DDEX поставщиком. Это позволяет клиентам DDEX проверка возможностей данного поставщика без загрузки любой код поставщика. Это полезно при репликации через набор поставщиков для определения отфильтрованный список поставщиков, поддерживающих определенный набор сущностей поддержки.

Поставщик добавляет DDEX различные разделы реестра в SupportedObjects ключом в соответствующем разделе реестра корневого элемента. Эти ключи содержат имена каждого типа сущности, которая поддерживается. Имя ключа должно быть не пустой строкой, внешние сдвига или заканчиваться пробелом и должно представлять или расширяемое или полное имя типа сущности поддержки. расширяемая сущность поддержки неправомочное имя типа, развернуто до полного имени типа, prepending пространство имен Microsoft.VisualStudio.Data.Services.SupportEntities. Некоторые специальные исключения из этого правила. Эти исключения включают сущности поддержки IVsDataProviderDynamicSupport и IVsDataSourceSpecializer; их имена предваряются словами с пространством имен Microsoft.VisualStudio.Data.Core.

Примечание

DDEX в Visual Studio 2005 считывает разделы реестра, которые определяют типы сущностей поддержки в сборке Microsoft.VisualStudio.Data.DDEX в Visual Studio 2008 по-прежнему считывает эти разделы реестра в целях совместимости и сопоставляет типы сущностей в старых поддержки новых.Например, вызов метода SupportsObject для поставщика Visual Studio 2005 DDEX с типом IVsDataConnectionProperties возвращает true, если поставщик зарегистрирован старого типа сущности DataConnectionProperties поддержки.

Помимо разделы реестра сущности поддержки, поставщик может добавлять DDEX подразделы в заданную объектным ключом поддержки, представляющие определенные источники данных, для которых DDEX сущность поддержки поддерживается. Если такие подразделы не существует, то подразумевается, что поддерживается сущность поддержки для всех источников данных DDEX. Если один или несколько подразделов существуют, то подразумевается, что сущность поддерживается только для поддержки определенных источников данных DDEX. Если сущность имеет поддержки и стандартную реализацию неспецифичных источников данных DDEX помимо реализации для отдельных источников данных DDEX, должно быть подраздела с пустой GUID. Также следует подразделы для отдельных источников данных DDEX. Если любой подраздела не является допустимым идентификатором GUID, игнорируется.

Если заданный тип сущности поддержки определяется наличие реализацию по умолчанию, этот метод всегда возвращает true.

Примеры

В следующем примере демонстрируется, как определить, поддерживает ли указанный поставщик DDEX метод для подключения к определенному источнику данных в контексте пользовательского интерфейса подключения.

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

Безопасность платформы .NET Framework

См. также

Ссылки

IVsDataProvider Интерфейс

SupportsObject - перегрузка

Microsoft.VisualStudio.Data.Core - пространство имен