Condividi tramite


Interfaccia IVsDataProviderDynamicSupport

Consente di modificare il supporto di un provider di DDEX, delle origini supportati e delle operazioni specifiche, in base all'ambiente corrente.

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

Sintassi

'Dichiarazione
Public Interface IVsDataProviderDynamicSupport
public interface IVsDataProviderDynamicSupport
public interface class IVsDataProviderDynamicSupport
type IVsDataProviderDynamicSupport =  interface end
public interface IVsDataProviderDynamicSupport

Il tipo IVsDataProviderDynamicSupport espone i seguenti membri.

Proprietà

  Nome Descrizione
Proprietà pubblica IsProviderSupported Ottiene un valore che indica se il provider è supportato nell'ambiente corrente.

In alto

Metodi

  Nome Descrizione
Metodo pubblico GetUnsupportedReason Ottiene una stringa localizzata che descrive la causa di un'operazione non è supportata, per l'origine dati specificata di DDEX.
Metodo pubblico IsOperationSupported Determina se un'operazione specifica supportata nell'ambiente corrente, per l'origine dati specificata di DDEX.
Metodo pubblico IsSourceSupported Ottiene un valore che indica se un'origine dati specifica di DDEX è supportata da questo provider di DDEX nell'ambiente corrente.

In alto

Note

Un provider di DDEX registra la propria esistenza per un'installazione particolare di Visual Studio aggiungendo le chiavi del Registro di sistema specifiche nell'hive del Registro di sistema locale di Visual Studio. In condizioni normali, la registrazione è sufficiente che il provider esiste e deve essere disponibile per l'utilizzo nell'istanza di Visual Studio. Tuttavia, in alcuni casi è necessario consentire al provider di DDEX dinamicamente determinare se è supportata nell'ambiente o, se supporta un'origine dati specifico o di determinate operazioni. Può trattarsi il caso i componenti debbano utilizzare o inviate dal provider di DDEX non sono installati, ad esempio, un provider di runtime ADO.NET che il provider di DDEX rappresenta in fase di progettazione.

Questa entità di supporto consente al provider di DDEX di scegliere quando è disponibile nell'ambiente, che le origini dati può supportare e che le operazioni specifiche sono consentiti. La prima delle due opzioni se il provider di dati e/o l'origine dati vengono enumerati e restituiti dai servizi IVsDataSourceManager e IVsDataProviderManager, rispettivamente. La terza opzione influisce sul comportamento IsOperationSupported metodi e GetUnsupportedReason.

Esempi

Il codice seguente viene illustrato come un provider di DDEX può implementare questa entità di supporto tramite la logica specifica che altera dinamicamente la disponibilità in fase di progettazione, come l'esistenza di una chiave specifica del Registro di sistema.

using System;
using System.ComponentModel.Design;
using Microsoft.Win32;
using Microsoft.VisualStudio.Data.Core;

internal class MyProviderDynamicSupport : IVsDataProviderDynamicSupport
{
    public bool IsProviderSupported
    {
        get
        {
            RegistryKey key = Registry.LocalMachine.OpenSubKey(
                @"SOFTWARE\Company\AdoDotNetProvider");
            if (key == null)
            {
                return false;
            }
            key.Close();
            return true;
        }
    }

    public bool IsSourceSupported(Guid source)
    {
        return true;
    }

    public bool IsOperationSupported(
        Guid source, CommandID command, object context)
    {
        return true;
    }

    public string GetUnsupportedReason(
        Guid source, CommandID command, object context)
    {
        return null;
    }
}

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.VisualStudio.Data.Core