Freigeben über

IVsDataProvider.IsOperationSupported-Methode (Guid, CommandID, Object)

  • Artikel

Bestimmt, ob ein Einzelgeschäft vom Anbieter in die aktuelle Umgebung unterstützt wird, für die angegebene DDEX-Datenquelle.

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

Syntax

'Declaration
Function IsOperationSupported ( _
    source As Guid, _
    command As CommandID, _
    context As Object _
) As Boolean

bool IsOperationSupported(
    Guid source,
    CommandID command,
    Object context
)

bool IsOperationSupported(
    Guid source, 
    CommandID^ command, 
    Object^ context
)

abstract IsOperationSupported : 
        source:Guid * 
        command:CommandID * 
        context:Object -> bool

function IsOperationSupported(
    source : Guid, 
    command : CommandID, 
    context : Object
) : boolean

Parameter

  • source
    Typ: Guid

    Ein DDEX-Datenquellenbezeichner.

  • command
    Typ: CommandID

    Ein Befehl, der den Vorgang identifiziert.

  • context
    Typ: Object

    Ein Objekt, das den Kontext darstellt, in dem der Vorgang vorhanden ist.

Rückgabewert

Typ: Boolean
true , wenn der Vorgang vom Anbieter in die aktuelle Umgebung unterstützt wird; andernfalls false.

Ausnahmen

Ausnahme Bedingung
ArgumentNullException

Der command-Parameter ist nullein Nullverweis (Nothing in Visual Basic).
[<ANY>]

Die IsOperationSupported des DDEX- implementierung Anbieters hat eine Ausnahme aus.

Hinweise

Diese Methode können DDEX-Clients, um sicherzustellen, dass Einzelgeschäfte durch einen DDEX-Anbieter in der aktuellen Umgebung unterstützt werden. Die Umgebung kann variieren, je nach Version von Visual Studio ausgeführt wird und der Laufzeitkomponenten auf dem Computer installiert werden. Erstere wird in der Regel durch die Edition von Visual Studio (beispielsweise, einige Befehle auf den Express-Editionen restriktiv), gesteuert, während das zweite Element in der Regel durch IVsDataProviderDynamicSupport Implementierung eines Anbieters gesteuert wird, sofern vorhanden.

Viele Vorgänge treten in eines größeren Kontexts auf. Das einfachste Beispiel hierfür ist der Befehl für geöffnete die Verbindung, die im Kontext einer bestimmten Verbindung fungiert. Der context-Parameter von IsOperationSupported aktiviert ein erkennbares in zu übergebene und Objekt, als Teil zum Bestimmen verwendet, ob eine Operation unterstützt wird.

IsOperationSupported Startet durch das Bestimmen, dass die Version von Visual Studio den Vorgang unterstützt. Wenn Visual Studio den Vorgang unterstützt und der Anbieter eine IVsDataProviderDynamicSupport Implementierung angegeben hat, fragt die Methode den Anbieter ab, um festzustellen, ob eine Operation unterstützt wird.

Beachten Sie, dass standardmäßig die Visual Studio-Edition alle Befehle unterstützt und eine Gruppe ausgewählter Befehle unter bestimmten Bedingungen ausschließt. Dies bedeutet, dass benutzerdefinierte Anbietervorgänge anhand der Visual Studio-Edition unterstützt werden und daher vom Anbieter gesteuert werden.

Beispiele

Der folgende Code zeigt, wie diese Methode aufruft, um zu bestimmen, ob der Anbieter das Löschen eines bestimmten Datenexplorerknotens unterstützt. Wenn nicht, wird die GetUnsupportedReason-Methode auf, um eine entsprechende Meldung zu ermitteln, um zu erläutern, warum der Vorgang nicht unterstützt wird.

C#

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

public class DDEX_IVsDataProviderExample8
{
    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;
    }
}

.NET Framework-Sicherheit

Siehe auch

Referenz

IVsDataProvider Schnittstelle

IsOperationSupported-Überladung

Microsoft.VisualStudio.Data.Core-Namespace