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 のデータ ソース ID、つまり Empty。
- objType
型 : System.Type
DDEX のサポートのエンティティの型。
戻り値
型 : System.Boolean
DDEX プロバイダーが指定 DDEX のデータ ソースの DDEX のサポートのエンティティ型の指定をサポートtrue ; それ以外 false。
例外
| 例外 | 条件 |
|---|---|
| ArgumentNullException | objType パラメーターが nullnull 参照 (Visual Basic では Nothing) です。 |
解説
DDEX プロバイダーが指定 DDEX のサポートのエンティティをサポートするかどうかの決定が DDEX プロバイダーによってレジストリに追加情報に基づいています。これは、プロバイダー コードを読み込まずに特定のプロバイダーの機能を調べることが DDEX のクライアントができます。これは、特定のセットのサポートのエンティティをサポートするプロバイダーの一覧をフィルター処理を判断するプロバイダーのセットを反復処理する場合に便利です。
DDEX プロバイダーは、ルート レジストリ キーの下に SupportedObjects キーの下にさまざまなレジストリ キーを追加します。これらのキーは、でサポートされているサポートのエンティティの各型の名前を指定します。キー名は無関係に、先頭または末尾の空白とせずに、空でない文字列で、エンティティのサポートの拡張できるかを完全修飾型名である必要があります。拡張できるサポート エンティティは 完全修飾型名に Microsoft.VisualStudio.Data.Services.SupportEntities の名前空間の追加によって配置される非修飾型名です。この場合、特定の例外があります。これらの例外は Microsoft.VisualStudio.Data.Core の名前空間に追加する IVsDataProviderDynamicSupport と IVsDataSourceSpecializer のサポートのエンティティが含まれています。
[!メモ]
Visual Studio 2005 の DDEX は Microsoft.VisualStudio.Data のアセンブリのサポートのエンティティ型を識別するレジストリ キーを読み取ります。Visual Studio 2008 の DDEX は、互換性のためにこれらのレジストリ キーを読み取り、新しいものに古いサポートのエンティティ型をマップします。たとえば、IVsDataConnectionProperties の型を持つ Visual Studio 2005 DDEX プロバイダーの SupportsObject のメソッドの呼び出しは、プロバイダーが古い DataConnectionProperties のサポートのエンティティ型を登録する場合 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 セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。