Condividi tramite

Metodo IVsDataProvider.SupportsObject (Guid, Type)

  • Articolo

Determina se un provider di DDEX supporta il tipo specificato di entità del supporto tecnico DDEX per l'origine dati specificata di DDEX.

Spazio dei nomi:  Microsoft.VisualStudio.Data.Core
Assembly:  Microsoft.VisualStudio.Data.Core (in Microsoft.VisualStudio.Data.Core.dll)

Sintassi

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

Parametri

  • source
    Tipo: Guid

    Un identificatore di origine dati di DDEX, o Empty ad alcuna origine dati specifica.

  • objType
    Tipo: Type

    Un tipo di entità del supporto tecnico DDEX.

Valore restituito

Tipo: Boolean
true se il provider di DDEX supporta il tipo specificato di entità del supporto tecnico DDEX per l'origine dati specificata di DDEX; in caso contrario, false.

Eccezioni

Eccezione Condizione
ArgumentNullException

Il parametro objType è nullriferimento null (Nothing in Visual Basic).

Note

La stabilire se un provider di DDEX supporta un'entità specificata di supporto di DDEX si basa sulle informazioni che vengono aggiunti al Registro di sistema dal provider di DDEX. Ciò consente ai client di DDEX per controllare le funzionalità di un provider specificato senza che sia necessario caricare il codice del provider. Questa funzione è utile quando si scorrendo il set di provider per determinare un elenco filtrato di provider che supportano un particolare set di entità di supporto.

Un provider di DDEX aggiunge le varie chiavi del Registro di sistema sotto una chiave di SupportedObjects con la propria chiave del Registro di sistema radice. Queste chiavi sono i nomi di ogni tipo di entità di supporto che è supportata. Il nome della chiave deve essere una stringa non vuota senza spazi vuoti iniziali o finali estraneo e deve rappresentare un nome di tipo completo o espandibile di un'entità di supporto. Un'entità espandibile di supporto è un nome di tipo che non è espanso in un nome di tipo completo allo spazio dei nomi di Microsoft.VisualStudio.Data.Services.SupportEntities. Esistono alcune eccezioni speciali a questo. Queste eccezioni sono incluse le entità di supporto IVsDataSourceSpecializer e IVsDataProviderDynamicSupport, ovvero anteposte con lo spazio dei nomi di Microsoft.VisualStudio.Data.Core.

Nota

DDEX in Visual Studio 2005 consente di leggere le chiavi del Registro di sistema che identificano i tipi di entità supporto dell'assembly di Microsoft.VisualStudio.Data.DDEX in Visual Studio 2008 ancora legge le chiavi del Registro di sistema per ragioni di compatibilità ed esegue il mapping dei tipi di entità recenti di supporto nei nuovi.Ad esempio, una chiamata al metodo SupportsObject per un provider di Visual Studio 2005 DDEX con il tipo IVsDataConnectionProperties restituirà true se il provider ha registrato il tipo di entità precedente del supporto tecnico DataConnectionProperties.

Oltre a queste chiavi del Registro di sistema di supporto, un provider di DDEX può aggiungere le sottochiavi sotto una chiave di identità specificata di supporto che rappresentano le origini dati specifiche di DDEX per cui l'entità di supporto è supportata. Se nessuna tali sottochiave esistente, l'entità di supporto costituisca supporto per tutte le origini dati di DDEX. Se uno o più sottochiavi esistono, l'entità di supporto costituisca supporto solo alle origini dati specifica di DDEX. Se un principale di supporto include sia un'implementazione standard per le origini dati non specifiche di DDEX oltre a implementazioni per le origini dati specifiche di DDEX, deve essere una sottochiave con un GUID vuoto. Devono inoltre essere sottochiavi per le origini dati specifiche di DDEX. Se una sottochiave non è un GUID valido, viene ignorata.

Se il tipo di entità specificato di supporto viene definito con un'implementazione predefinita, questo metodo restituisce sempre true.

Esempi

Il codice seguente viene illustrato come individuare se un provider specifico di DDEX supporta un metodo per la connessione a un'origine dati specificata nel contesto di un'interfaccia utente di connessione.

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

Sicurezza di .NET Framework

Vedere anche

Riferimenti

IVsDataProvider Interfaccia

Overload SupportsObject

Spazio dei nomi Microsoft.VisualStudio.Data.Core