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

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
    Тип: System.Guid
    Идентификатор источника данных для Empty DDEX или без конкретного источника данных.
  • objType
    Тип: System.Type
    Тип сущности поддержки DDEX.

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

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

Исключения

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

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

Заметки

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

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

ПримечаниеПримечание

DDEX в Visual Studio 2005 считывает разделы реестра, которые определяют типы сущностей поддержки в сборке Microsoft.VisualStudio.Data.DDEX в Microsoft 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 - пространство имен