IVsDataProviderDynamicSupport.GetUnsupportedReason – metoda

Článek
10/27/2012

Získá lokalizovaný řetězec popisující důvod 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.

command
Typ: System.ComponentModel.Design.CommandID
Příkaz identifikaci operace.

context
Typ: System.Object
Objekt představující kontext, ve kterém existuje operace.

Vrácená hodnota

Typ: System.String
Lokalizovaný řetězec popisující, 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).
ArgumentException	context Parametr není pro zadanou operaci očekávané hodnoty.

Poznámky

Tato metoda umožňuje poskytovatelům DDEX vrátit určitý důvod, že operace není podporována.DDEX klienty můžete zobrazit z tohoto důvodu uživateli.

Příklady

Následující kód ukazuje, jak implementovat tato metoda vrátí užitečné zprávu při nasazení příkaz připojení uzlu Průzkumník dat není podporován.

using System;
using System.ComponentModel.Design;
using Microsoft.Win32;
using Microsoft.VisualStudio.Data.Core;
using Microsoft.VisualStudio.Data.Services;

public class MyProviderDynamicSupport2 : IVsDataProviderDynamicSupport
{
    private static readonly CommandID DeployCommand =
        new CommandID(new Guid("6535F307-2083-4cbb-B2FA-11F2DCD69DAF"), 25);

    public bool IsProviderSupported
    {
        get
        {
            return true;
        }
    }

    public bool IsSourceSupported(Guid source)
    {
        return true;
    }

    public bool IsOperationSupported(
        Guid source, CommandID command, object context)
    {
        if (command == null)
        {
            throw new ArgumentNullException("command");
        }
        if (command.Equals(DeployCommand))
        {
            IVsDataExplorerConnection explorerConnection =
                context as IVsDataExplorerConnection;
            if (explorerConnection == null)
            {
                throw new ArgumentException();
            }
            RegistryKey key = Registry.LocalMachine.OpenSubKey(
                @"SOFTWARE\Company\DeployTechnology");
            if (key == null)
            {
                return false;
            }
            key.Close();
        }
        return true;
    }

    public string GetUnsupportedReason(
        Guid source, CommandID command, object context)
    {
        if (command == null)
        {
            throw new ArgumentNullException("command");
        }
        if (command.Equals(DeployCommand) &&
            !IsOperationSupported(source, command, context))
        {
            // Note: This string should be localized
            return "In order to deploy a database you need to install our deployment technology.";
        }
        return null;
    }
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

IVsDataProviderDynamicSupport Rozhraní

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

Sdílet prostřednictvím