Sdílet prostřednictvím

IVsDataProvider.SupportsObject – metoda (Guid, Type)

  • Článek

Určuje, zda DDEX provider podporuje zadaný typ entity DDEX podporu pro určený zdroj dat DDEX.

Obor názvů:  Microsoft.VisualStudio.Data.Core
Sestavení:  Microsoft.VisualStudio.Data.Core (v Microsoft.VisualStudio.Data.Core.dll)

Syntaxe

'Deklarace
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

Parametry

  • source
    Typ: System.Guid
    Identifikátor zdroje dat DDEX nebo Empty pro žádný určitý datový zdroj.

Vrácená hodnota

Typ: System.Boolean
true Pokud zprostředkovatel DDEX podporuje zadaný typ entity DDEX podporu pro určený zdroj dat DDEX; jinak false .

Výjimky

Výjimka Podmínka
ArgumentNullException

The objType parameter is nullodkaz null (Nothing v jazyce Visual Basic).

Poznámky

Stanovení, zda DDEX provider podporuje zadané entity DDEX podpora je na základě informací, DDEX provider přidat do registru.To umožňuje klientům DDEX zkontrolovat možnosti daného poskytovatele bez nutnosti načíst kód poskytovatele.To je užitečné, když jsou iterace sadu poskytovatelů určit filtrovaný seznam zprostředkovatelů, které podporují sadu podpory subjektů.

Přidá zprostředkovatele DDEX různých klíčů registru v klíči SupportedObjects podle jejich kořenový klíč registru.Tyto klíče poskytují názvy jednotlivých typů podpory entita, která je podporována.Název klíče musí být neprázdný řetězec bez cizích úvodní a koncové mezery a musí představovat buď typu rozbalitelné nebo plně kvalifikovaný název entity podpory.Entity rozbalitelné podporu je typ neúplný název, který je vyplněn zadejte úplný název v oboru názvů Microsoft.VisualStudio.Data.Services.SupportEntities prepending.Existují některé zvláštní výjimky.Tyto výjimky zahrnují IVsDataProviderDynamicSupport a IVsDataSourceSpecializer podporují entity, které jsou předponou Microsoft.VisualStudio.Data.Core oboru názvů.

[!POZNÁMKA]

V aplikaci Visual Studio 2005 DDEX čte klíče registru, které identifikují typy podpory entity v sestavení Microsoft.VisualStudio.Data.DDEX Visual Studio 2008 stále čte tyto klíče registru pro účely kompatibility a mapuje staré typy entity podpory do nových.Například volání SupportsObject metoda pro Visual Studio 2005 DDEX provider se IVsDataConnectionProperties vrátí typ true Pokud zprostředkovatel registrován staré DataConnectionProperties podporu typu entity.

Kromě těchto klíčů registru entity podporu DDEX provider přidat podklíče pod klíčem dané podpory entity, které představují konkrétní DDEX zdroje dat pro které entita podpory je podporována.Pokud neexistují žádné těchto podklíčů, podpora subjekt považován podporován pro všechny zdroje dat DDEX.Pokud jeden nebo více podklíčů, podpora subjekt považován podporovány pouze zadané zdroje dat DDEX.Podpora subjekt má obě standardní implementace pro zdroje dat nespecifickém DDEX kromě implementace pro konkrétní zdroje dat DDEX, musí být podklíč s prázdný identifikátor GUID.Rovněž musí být podklíče pro konkrétní zdroje dat DDEX.Pokud některý podklíč není platný identifikátor GUID, je ignorován.

Pokud je definován typ entity zadané podpory mít výchozí implementace, tato metoda vrátí vždy true .

Příklady

Následující kód ukazuje, jak určit, zda zadaný zprostředkovatel DDEX podporuje metodu pro připojení ke zdroji dat zadané v rámci připojení uživatelského rozhraní.

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

Zabezpečení rozhraní .NET Framework

Viz také

Referenční dokumentace

IVsDataProvider Rozhraní

SupportsObject – přetížení

Microsoft.VisualStudio.Data.Core – obor názvů