Metodo IVsDataProvider.GetUnsupportedReason (Guid, CommandID, Object)

Ottiene una stringa localizzata che informa che un'operazione non è supportata 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 GetUnsupportedReason ( _
    source As Guid, _
    command As CommandID, _
    context As Object _
) As String

string GetUnsupportedReason(
    Guid source,
    CommandID command,
    Object context
)

String^ GetUnsupportedReason(
    Guid source, 
    CommandID^ command, 
    Object^ context
)

abstract GetUnsupportedReason : 
        source:Guid * 
        command:CommandID * 
        context:Object -> string

function GetUnsupportedReason(
    source : Guid, 
    command : CommandID, 
    context : Object
) : String

Parametri

• source
  Tipo: Guid

  Un identificatore di origine dati di DDEX.

• command
  Tipo: CommandID

  Un comando che identifica l'operazione.

• context
  Tipo: Object

  Oggetto che rappresenta il contesto in cui l'operazione esiste.

Valore restituito

Tipo: String
Stringa localizzata che informa che l'operazione specificata non è supportata, se l'operazione in effetti non è supportata; in caso contrario, nullriferimento null (Nothing in Visual Basic).

Eccezioni

Eccezione	Condizione
ArgumentNullException	Il parametro command è nullriferimento null (Nothing in Visual Basic).
[<ANY>]	L'implementazione di GetUnsupportedReason del provider di DDEX viene generata un'eccezione.

Note

Questo metodo consente ai client di DDEX per fornire agli utenti un motivo specifico che spiegano perché un'operazione che ha tentato di eseguire non è supportata nell'ambiente corrente. L'ambiente può variare, a seconda della versione di Visual Studio è in esecuzione e i componenti di runtime installati nel computer. Il precedente viene in genere controllata dall'edizione di Visual Studio, ad esempio limitante alcuni controlli nelle edizioni express), mentre l'ultimo in genere controllata dall'implementazione IVsDataProviderDynamicSupport di un provider, se presente.

Molte operazioni vengono eseguite nel contesto più ampio. L'esempio più semplice di questo comando è aperto per la connessione, che si verifica nel contesto di una connessione specifica. Il parametro contextGetUnsupportedReason attiva un oggetto riconoscibile da passare a e utilizzare come parte della definizione del motivo per il supporto dell'operazione.

Questo metodo viene avviato come determinare se la versione di Visual Studio ha un motivo per il supporto dell'operazione. Se questa query restituisce nullriferimento null (Nothing in Visual Basic) ovvero Visual Studio non ha motivo per il supporto dell'operazione) e il provider fornisce un'implementazione IVsDataProviderDynamicSupport, eseguire una query sul provider per un motivo per il supporto dell'operazione.

Esempi

Il codice seguente viene illustrato come chiamare il metodo IsOperationSupported per determinare se il provider supporta l'eliminazione di un determinato nodo di esplora di dati. In caso contrario, il codice chiama GetUnsupportedReason per determinare un messaggio appropriato per descrivere poiché l'operazione non è supportata.

using System;
using System.Windows.Forms;
using System.ComponentModel.Design;
using Microsoft.VisualStudio.Data.Core;
using Microsoft.VisualStudio.Data.Services;

public class DDEX_IVsDataProviderExample7
{
    public static bool AllowDelete(IVsDataProvider provider,
        IVsDataExplorerNode node)
    {
        if (!provider.IsOperationSupported(StandardCommands.Delete, node))
        {
            MessageBox.Show(provider.GetUnsupportedReason(
                StandardCommands.Delete, node));
            return false;
        }
        return true;
    }
}

Sicurezza di .NET Framework

• Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

IVsDataProvider Interfaccia

Overload GetUnsupportedReason

Spazio dei nomi Microsoft.VisualStudio.Data.Core