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

Obtiene una cadena traducida que explica por qué una operación no se admite para el origen de datos especificado de DDEX.

Espacio de nombres:  Microsoft.VisualStudio.Data.Core
Ensamblado:  Microsoft.VisualStudio.Data.Core (en Microsoft.VisualStudio.Data.Core.dll)

Sintaxis

'Declaración
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

Parámetros

• source
  Tipo: System.Guid
  Un identificador de origen de datos de DDEX.

• command
  Tipo: System.ComponentModel.Design.CommandID
  Un comando que identifica la operación.

• context
  Tipo: System.Object
  Un objeto que representa el contexto en el que la operación existe.

Valor devuelto

Tipo: System.String
Una cadena traducida que explica por qué la operación especificada no se admite, si la operación de hecho no se admite; si no, nullreferencia null (Nothing en Visual Basic).

Excepciones

Comentarios

Este método permite a los clientes de DDEX para proporcionar a los usuarios con una razón concreta que explican por qué una operación que intentaron realizar no se admite en el entorno actual.El entorno puede variar, dependiendo de que la edición de Visual Studio se está ejecutando y de que se instalan los componentes del runtime en el equipo.El primero se controla normalmente por la edición de Visual Studio (por ejemplo, limitando algunos comandos en las ediciones Express), mientras que este último se controla normalmente por la implementación de IVsDataProviderDynamicSupport de un proveedor, si hubiera.

Muchas operaciones aparecen dentro de algún contexto más grande.El ejemplo más simple es de comando abierto para la conexión, que aparece en el contexto de una conexión determinada.El parámetro de context de GetUnsupportedReason habilita un objeto reconocible que pase en y se usa como parte de determinar el motivo de no admitir la operación.

Este método inicia determinando si la edición de Visual Studio tiene una razón de no admitir la operación.Si esta consulta devuelve nullreferencia null (Nothing en Visual Basic) (es decir, Visual Studio no tiene ninguna razón de no admitan la operación) y el proveedor ha proporcionado una implementación de IVsDataProviderDynamicSupport , consulta el proveedor por razones de no admitir la operación.

Ejemplos

El código siguiente se muestra cómo llamar al método de IsOperationSupported para determinar si el proveedor admite eliminar un nodo determinado del explorador de los datos.Si no es así, el código llama a GetUnsupportedReason para determinar un mensaje adecuado para describir por qué la operación no se admite.

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

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

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

IVsDataProvider Interfaz

GetUnsupportedReason (Sobrecarga)

Microsoft.VisualStudio.Data.Core (Espacio de nombres)