Sdílet prostřednictvím

IVsDataProvider.GetUnsupportedReason – metoda (Guid, CommandID, Object)

  • Článek

Získá lokalizovaným řetězcem, který vysvětluje, proč operace není podporována 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 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

Parametry

  • source
    Typ: System.Guid
    DDEX zdrojový identifikátor data.
  • context
    Typ: System.Object
    Objekt představující kontext, ve kterém existuje operace.

Vrácená hodnota

Typ: System.String
Lokalizovaný řetězec, který vysvětluje, proč uvedená operace není podporována, pokud operace není podporována ve skutečnosti; jinak null .

Výjimky

Výjimka Podmínka
ArgumentNullException

The command parameter is nullodkaz null (Nothing v jazyce Visual Basic).
[<ANY>]

Zprostředkovatel DDEX GetUnsupportedReason implementace došlo k výjimce.

Poznámky

Tato metoda umožňuje klientům DDEX uživatelům poskytnout zvláštní důvod vysvětlující, proč není podporován, který se pokusil provést operaci v aktuálním prostředí.Prostředí mohou lišit v závislosti na verzi aplikace Visual Studio běží a runtime součásti, které jsou nainstalovány v počítači.Bývalé obvykle řídí edici sady Visual Studio (například omezení některé příkazy edice Express), že jsou obvykle řízeny podle poskytovatele a IVsDataProviderDynamicSupport provedení, pokud existuje.

Mnoho operací nastat některé větší kontextu.Je to nejjednodušší příklad příkazu Otevřít připojení dochází v souvislosti s konkrétní připojení. context Parametr GetUnsupportedReason umožňuje rozpoznat objektu předaný a použit jako část určení důvodu nepodporuje operaci.

Určení, zda má edici sady Visual Studio důvod nepodporuje operaci tuto metodu spustí.Tento dotaz vrátí null (Visual Studio, nemá žádný důvod nepodporuje operace) a poskytl IVsDataProviderDynamicSupport provádění dotazů zprostředkovatel důvod nepodporuje operaci.

Příklady

Následující kód ukazuje způsob volání IsOperationSupported metoda k určení, zda zprostředkovatel podporuje odstranění uzlu explorer zejména údaje.Pokud ne, kód volání GetUnsupportedReason k určení příslušnou zprávu popisující, proč není operace podporována.

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

Zabezpečení rozhraní .NET Framework

Viz také

Referenční dokumentace

IVsDataProvider Rozhraní

GetUnsupportedReason – přetížení

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