IVsDataProvider.SupportsObject-Methode (Guid, Type)

Bestimmt, ob ein DDEX-Anbieter den angegebenen Typ der DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle unterstützt.

Namespace:  Microsoft.VisualStudio.Data.Core
Assembly:  Microsoft.VisualStudio.Data.Core (in Microsoft.VisualStudio.Data.Core.dll)

Syntax

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

Parameter

• source
  Typ: Guid

  Ein DDEX-Datenquellenbezeichner oder Empty für eine bestimmte Datenquelle.

• objType
  Typ: Type

  Ein Typ DDEX-Unterstützungsentität.

Rückgabewert

Typ: Boolean
true , wenn der DDEX-Anbieter den angegebenen Typ der DDEX-Unterstützungsentität für die angegebene DDEX-Datenquelle unterstützt; andernfalls false.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Der objType-Parameter ist nullein Nullverweis (Nothing in Visual Basic).

Hinweise

Identifizieren von, ob ein DDEX-Anbieter eine angegebene DDEX-Unterstützungsentität unterstützt, ist auf Informationen, die zur Registrierung vom DDEX-Anbieter hinzugefügt wird. Dadurch können DDEX-Clients, um die angegebenen Funktionen eines Anbieters zu überprüfen, ohne zu müssen, Code eines beliebigen Anbieters zu laden. Dies ist hilfreich, wenn Sie durch den Satz von Anbietern durchlaufen, um eine gefilterte Anbieterliste zu bestimmen, die eine bestimmte Gruppe unterstützen, die von den Unterstützungsentitäten festgelegt wird.

Ein DDEX-Anbieter fügt andere Registrierungsschlüssel unter einer SupportedObjects-Taste unter dem Stammregistrierungsschlüssel hinzu. Diese stellen Schlüssel die Namen jedes Typs Unterstützungsentität, die unterstützt wird. Der Schlüssel muss eine nicht leere äußere ohne führende oder nachgestellte Leerzeichen sein und muss entweder ein erweiterbares oder vollqualifizierten Typnamen einer Unterstützungsentität darstellen. Eine erweiterbare Unterstützungsentität ist ein nicht qualifizierter Typname, der einem vollqualifizierten Typnamen erweitert wird, indem der Microsoft.VisualStudio.Data.Services.SupportEntities-Namespace vorangestellt wird. Es gibt einige spezielle Ausnahmen zu diesem. Diese Ausnahmen enthalten die IVsDataProviderDynamicSupport und IVsDataSourceSpecializer Unterstützungsentitäten, die dem Microsoft.VisualStudio.Data.Core-Namespace vorangestellt werden.

Hinweis

DDEX in Visual Studio 2005 wird Registrierungsschlüssel, die Unterstützungsentitätstypen in der Microsoft.VisualStudio.Data-Assembly identifizieren.DDEX in Visual Studio 2008 weiterhin liest diese Registrierungsschlüssel an Kompatibilitätszwecken und ordnet den alten Unterstützungsentitätstypen in die neue zu.Beispielsweise gibt ein Aufruf der SupportsObject-Methode für einen Anbieter Visual Studio die DDEX IVsDataConnectionProperties mit dem Typ true zurück, wenn der Anbieter den alten DataConnectionProperties-Unterstützungsentitätstyp registrierte.

Neben diesen Unterstützungsentitäts-Registrierungsschlüsseln kann ein DDEX-Anbieter Unterschlüssel unter einer bestimmten Unterstützungsentitätsschlüssel hinzufügen, die bestimmte DDEX-Datenquellen darstellen, für die die Unterstützungsentität unterstützt wird. Wenn diese Unterschlüssel vorhanden sind, wird die Unterstützungsentität angenommen, für alle DDEX-Datenquellen unterstützt werden. Wenn mindestens Unterschlüssel vorhanden sind, wird die Unterstützungsentität angenommen, nur für die angegebenen DDEX-Datenquellen unterstützt werden. Wenn eine Unterstützungsentität eine Standardimplementierung für unspezifische DDEX-Datenquellen neben den Implementierungen für bestimmte DDEX-Datenquellen hat, muss es einen Unterschlüssel mit einer leeren GUID geben. Es muss Unterschlüssel für bestimmte DDEX-Datenquellen auch geben. Wenn eine der Unterschlüssel keine gültige GUID, wird ignoriert.

Wenn der angegebene Unterstützungsentitätstyp definiert wird, um eine Standardimplementierung verfügt, gibt diese Methode immer true zurück.

Beispiele

Der folgende Code veranschaulicht, wie angegeben, ob ein angegebener DDEX-Anbieter eine Methode für die Verbindung an eine angegebene Datenquelle im Rahmen einer Verbindung Benutzeroberfläche unterstützt.

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-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

IVsDataProvider Schnittstelle

SupportsObject-Überladung

Microsoft.VisualStudio.Data.Core-Namespace