IVsDataProvider.GetUnsupportedReason 메서드 (Guid, CommandID, Object)

DDEX 데이터 원본에 지정 된 작업이 지원 되지 않습니다 이유를 설명 하는 지역화 된 문자열을 가져옵니다.

네임스페이스:  Microsoft.VisualStudio.Data.Core
어셈블리:  Microsoft.VisualStudio.Data.Core(Microsoft.VisualStudio.Data.Core.dll)

구문

‘선언
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

매개 변수

• source
  형식: System.Guid
  DDEX 데이터 소스 식별자입니다.

• command
  형식: System.ComponentModel.Design.CommandID
  작업을 식별 하는 명령입니다.

• context
  형식: System.Object
  작업에 존재 하는 컨텍스트를 나타내는 개체입니다.

반환 값

형식: System.String
작업이 실제로 지원 되지 않으면 지정한 작업이 지원 되지 않습니다 이유를 설명 하는 지역화 된 문자열입니다. 그렇지 않으면 nullNull 참조(Visual Basic의 경우 Nothing).

예외

설명

이 메서드는 DDEX 클라이언트를 사용자가 작업을 수행 하려고 현재 환경에서 지원 되지 않습니다 설명 하는 특별 한 이유가 수 있습니다.환경 Visual Studio 버전을 실행 하 고 런타임 구성 요소는 컴퓨터에 설치 된 따라 다를 수 있습니다.Visual Studio 버전 (예, 일부 명령은 Express 버전에 대 한 제한) 전자를 일반적으로 제어 후자는 일반적으로 공급자가 제어 하는 반면 IVsDataProviderDynamicSupport 구현입니다.

일부 큰 컨텍스트 내에서 많은 작업을 발생합니다.가장 간단한 예 열기 명령에 대 한 연결을 특정 연결의 컨텍스트에서 발생 됩니다.context 매개 변수를 GetUnsupportedReason 인식할 수 있는 개체에 전달 하 고 확인 작업을 지원에 대 한 이유의 일부로 사용할 수 있습니다.

이 메서드는 버전 Visual Studio 작업을 지원 하지는 이유가 있는지 여부를 확인 하 여 시작 합니다.이 쿼리를 반환 하는 경우 nullNull 참조(Visual Basic의 경우 Nothing) (즉, Visual Studio 작업을 지원 하지 않습니다 이유입니다)와 공급자가 제공한 경우는 IVsDataProviderDynamicSupport 구현에서 쿼리 공급자 작업을 지원에 대 한 이유 때문에.

예제

다음 코드를 호출 하는 방법을 보여 줍니다.를 IsOperationSupported 메서드를 공급자 특정 데이터 탐색기 노드 삭제를 지원 하는지 여부를 결정 합니다.코드 호출 하지 않는 경우 GetUnsupportedReason 작업이 지원 되지 않는 이유를 설명 하는 적절 한 메시지를 확인 합니다.

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

.NET Framework 보안

• 직접 실행 호출자의 경우 완전히 신뢰합니다. 이 멤버는 부분적으로 신뢰할 수 있는 코드에서 사용할 수 없습니다. 자세한 내용은 부분 신뢰 코드에서 라이브러리 사용을 참조하십시오.

참고 항목

참조

IVsDataProvider 인터페이스

GetUnsupportedReason 오버로드

Microsoft.VisualStudio.Data.Core 네임스페이스