Partilhar via

Método IVsDataProvider.IsOperationSupported (Guid, CommandID, Object)

  • Artigo

Determina se uma operação específica é suportada pelo provedor no ambiente atual, para a fonte de dados especificada de DDEX.

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

Sintaxe

'Declaração
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

Parâmetros

  • source
    Tipo: Guid

    Um identificador de fonte de dados de DDEX.

  • command
    Tipo: CommandID

    Um comando que identifica a operação.

  • context
    Tipo: Object

    Um objeto que representa o contexto no qual a operação existe.

Valor de retorno

Tipo: Boolean
true se a operação é suportada pelo provedor no ambiente atual; caso contrário, false.

Exceções

Exceção Condição
ArgumentNullException

O parâmetro command é nulluma referência nula (Nothing no Visual Basic).
[<ANY>]

A implementação de IsOperationSupported do provedor de DDEX apresentou uma exceção.

Comentários

Esse método permite que clientes de DDEX para verificar se as operações específicas são suportadas por um provedor de DDEX no ambiente atual. O ambiente pode diferir, dependendo do Visual Studio está executando e os componentes de tempo de execução são instalados no computador. O primeiro é geralmente controlados pela edição Visual Studio (por exemplo, para alguns comandos em express editions), enquanto o último normalmente é controlada pela implementação de IVsDataProviderDynamicSupport de um provedor, se houver.

Muitas operações ocorrem em um determinado contexto maior. O exemplo mais simples deste é o comando aberto para a conexão, que ocorre no contexto de uma conexão específico. O parâmetro de context de IsOperationSupported permite que um objeto reconhecível a ser passado e usado como parte de determinar se a operação é suportada.

inicia deIsOperationSupported determinando se a edição Visual Studio oferece suporte a operação. Se o Visual Studio oferece suporte a operação e o provedor forneceu uma implementação de IVsDataProviderDynamicSupport , o método consulta o provedor para determinar se a operação é suportada.

Observe que por padrão o Visual Studio oferece suporte a todos os comandos e exclui um conjunto de comandos selecione sob certas condições. Isso significa que as operações do provedor personalizado será suportadas pela edição Visual Studio e portanto são controladas pelo provedor.

Exemplos

O código a seguir demonstra como chamar esse método para determinar se o provedor oferecer suporte a exclusão de um nó específico do gerenciador de dados. Se não, chama o método de GetUnsupportedReason para determinar uma mensagem apropriada descrever como a operação não é suportada.

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

Segurança do .NET Framework

Consulte também

Referência

IVsDataProvider Interface

Sobrecargas IsOperationSupported

Namespace Microsoft.VisualStudio.Data.Core