共用方式為

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
    類型：Guid

    一 DDEX 資料來源識別項或 Empty 沒有指定資料來源的。

  • objType
    類型：Type

    DDEX 支援實體的型別。

傳回值

類型：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 命名空間