共用方式為

IVsDataProvider.SupportsObject 方法 (Guid, Type)

  • 發行項

判斷 DDEX 提供者是否支援指定的 DDEX DDEX 資料來源支援實體型別。

命名空間：  Microsoft.VisualStudio.Data.Core
組件：  Microsoft.VisualStudio.Data.Core (在 Microsoft.VisualStudio.Data.Core.dll 中)

語法

'宣告
Function SupportsObject ( _
    source As Guid, _
    objType As Type _
) As Boolean

bool SupportsObject(
    Guid source,
    Type objType
)

bool SupportsObject(
    Guid source, 
    Type^ objType
)

abstract SupportsObject : 
        source:Guid * 
        objType:Type -> bool 

function SupportsObject(
    source : Guid, 
    objType : Type
) : boolean

參數

  • source
    型別：System.Guid
    一 DDEX 資料來源識別項或 Empty 沒有特定資料來源的。
  • objType
    型別：System.Type
    DDEX 支援實體的型別。

傳回值

型別：System.Boolean
true ，如果 DDEX 提供者支援 DDEX 指定的 DDEX 資料來源支援實體的指定型別，否則， false。

例外狀況

例外狀況 條件
ArgumentNullException

objType 參數為 nullNull 參照 (即 Visual Basic 中的 Nothing)。

備註

判斷 DDEX 提供者是否支援指定的 DDEX 支援實體根據加入登錄為由 DDEX 提供者的相關資訊。這可讓 DDEX 用戶端檢查特定提供者的功能，而不需要載入所有提供者程式碼。這個方法很有用，當您將一組提供者逐一查看判斷支援一組特定實體的提供者支援的篩選清單時。

DDEX 提供者將不同的登錄機碼。SupportedObjects 機碼在其根登錄機碼之下。這些索引鍵提供支援的實體類型的名稱。機碼名稱。必須是非空白字串，並沒有直接關聯的前置或後端空白字元，而且必須表示支援實體的可展開或完整型別名稱。可展開的支援 實體是展開為完整的型別名稱會透過加上 Microsoft.VisualStudio.Data.Services.SupportEntities 命名空間中未限定的型別名稱。有一些特殊的例外狀況至這個。這些例外狀況包括 IVsDataProviderDynamicSupport 和 IVsDataSourceSpecializer 支援實體，前面加上 Microsoft.VisualStudio.Data.Core 命名空間。

注意事項注意事項

在 Visual Studio 2005 的 DDEX 讀取識別在 Microsoft.VisualStudio.Data 組件支援的實體型別的登錄機碼。在 Visual Studio 2008 中仍 DDEX 讀取相容性用途的下列登錄機碼並將舊支援實體型別至新的。例如，如果提供者，註冊支援舊 DataConnectionProperties 實體型別， SupportsObject 對方法的呼叫相當於 IVsDataConnectionProperties 類型的 Visual Studio 2005 DDEX 提供者的會傳回 true 。

除了這些支援實體登錄機碼以外， DDEX 提供者可以將表示特定 DDEX 資料來源支援實體所支援的子機碼在指定支援實體索引鍵下的目錄。如果這樣的子機碼不存在，支援實體已為所有 DDEX 資料來源支援。如果一或多個子機碼存在，支援實體假設只針對指定的 DDEX 資料來源支援。除了 DDEX 特定資料來源的實作之外，如果支援實體具有非特定的 DDEX 資料來源的標準實作，則必須有空白 GUID 的子機碼。必須有特定 DDEX 資料來源的子機碼。如果有任何子索引鍵不是有效的 GUID，它將會被忽略。

如果指定的支援實體型別定義有預設的實作，這個方法永遠會傳回 true。

範例

下列程式碼示範如何識別指定的 DDEX 提供者是否支援連接的方法轉換為指定的資料來源在連接 UI 中。

using System;
using Microsoft.VisualStudio.Data.Core;
using Microsoft.VisualStudio.Data.Services.SupportEntities;

public class DDEX_IVsDataProviderExample9
{
    public static bool HasSpecialConnectForUI(
        IVsDataProvider provider, Guid source)
    {
        return provider.SupportsObject(
            source, typeof(IVsDataConnectionUIConnector));
    }
}

.NET Framework 安全性

請參閱

參考

IVsDataProvider 介面

SupportsObject 多載

Microsoft.VisualStudio.Data.Core 命名空間