Método IVsDataProvider.IsOperationSupported (Guid, CommandID, Object)
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: System.Guid
Um identificador de fonte de dados de DDEX.
- command
Tipo: System.ComponentModel.Design.CommandID
Um comando que identifica a operação.
- context
Tipo: System.Object
Um objeto que representa o contexto no qual a operação existe.
Valor de retorno
Tipo: System.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 de 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 ser diferente, dependendo qual a edição Visual Studio está executando e os componentes de tempo de execução são instalados no computador.O primeiro é normalmente controlado pela edição Visual Studio (por exemplo, para alguns comandos nas edições), 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 de este é o comando aberto para a conexão, que ocorre no contexto de uma conexão específica.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 a edição Visual Studio oferece suporte a todos os comandos e exclui selecione um conjunto de comandos em certas condições.Isso significa que as operações do provedor personalizado será suporte para a 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 oferece suporte a exclusão de um nó específico do gerenciador de dados.Caso contrário, ele 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
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.