IVsDataProvider.IsOperationSupported - метод (Guid, CommandID, Object)

Статья
05/17/2015

Определяет, поддерживается ли конкретная операция поставщиком в окружающей среды в настоящее время для заданного источника данных DDEX.

Пространство имен: Microsoft.VisualStudio.Data.Core
Сборка: Microsoft.VisualStudio.Data.Core (в Microsoft.VisualStudio.Data.Core.dll)

Синтаксис

'Декларация
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

Параметры

source
Тип: Guid

Идентификатор источника данных DDEX.

command
Тип: CommandID

Команда, которая определяет операцию.

context
Тип: Object

Объект, представляющий контекст, в котором операция существует.

Возвращаемое значение

Тип: Boolean
true , если операция поддерживается поставщиком в окружающей среды в настоящий момент; в противном случае false.

Исключения

Исключение	Условие
ArgumentNullException	Значение параметра command — nullссылка NULL (Nothing в Visual Basic).
[<ANY>]	Реализация IsOperationSupported поставщика DDEX выдавать исключения.

Заметки

Этот метод позволяет клиентам DDEX проверки, поддерживаются ли определенные операции поставщиком DDEX в окружающей среды в данный момент. Среда может отличаться в зависимости от того, какой выпуск Visual Studio выполняется и которой компоненты среды выполнения устанавливаются на компьютере. Первое обычно настраивается с помощью выпуска Visual Studio (например, ограничивая некоторые команды в выпусках), а второй обычно задается реализацией IVsDataProviderDynamicSupport поставщика, если таковое имеется.

Многие операции выполняются в рамках определенного большего контекста. Простейшим примером этого открытую команду для подключения, которое происходит в контексте конкретного соединения. Параметр contextIsOperationSupported позволяет передавать в распознать два объекта и использоваться как часть определения поддерживается ли операция.

начинает IsOperationSupported, указав, поддерживает ли выпуска Visual Studio операцию. Если Visual Studio поддерживает операцию и поставщик использует реализацию IVsDataProviderDynamicSupport, появится метода поставщик, чтобы определить, поддерживается ли операция.

Обратите внимание, что по умолчанию выпуска Visual Studio поддерживает все команды и исключает выбранный набор команд при определенных условиях. Это означает, что операции пользовательского поставщика будут поддерживаться выпуска Visual Studio и поэтому управляются поставщиком.

Примеры

В следующем примере кода показано, как вызвать этот метод, чтобы определить, поддерживает ли поставщик удаление указанного узла обозревателя данных. В противном случае он вызывает метод GetUnsupportedReason для определения соответствующее сообщение для описания, почему операция не поддерживается.

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

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Для получения дополнительной информации см. Использование библиотек из не вполне надежного кода.