IVsDataProvider.GetProperty メソッド

DDEX プロバイダーの登録済みプロパティを取得します。

名前空間:  Microsoft.VisualStudio.Data.Core
アセンブリ:  Microsoft.VisualStudio.Data.Core (Microsoft.VisualStudio.Data.Core.dll 内)

構文

'宣言
Function GetProperty ( _
    name As String _
) As Object

Object GetProperty(
    string name
)

Object^ GetProperty(
    String^ name
)

abstract GetProperty : 
        name:string -> Object 

function GetProperty(
    name : String
) : Object

パラメーター

• name
  型 : System.String
  取得するプロパティの名前。

戻り値

型 : System.Object
存在する場合、プロパティの値; それ以外 nullnull 参照 (Visual Basic では Nothing)。

例外

解説

DDEX プロバイダーはプロバイダーの情報を確認するに DDEX のクライアントがアクセスできる一連のプロパティを登録できます。標準的なプロパティをプロバイダー名、表示名は、短い表示名、説明、およびテクノロジが含まれていますが、プロパティは、プロバイダーが含まれている場合があります。

プロパティ値は DDEX プロバイダーのルート レジストリ キーを開き、指定した名前を持つキーの下の値を要求することによって取得します。(ルート レジストリ キーは、Visual Studio のローカルなレジストリ ハイブの DataProviders キーの下にあります)。特定のプロパティが要求された後、値は DDEX のランタイムにメモリに Visual Studio を再起動するまで保存され、更新されません。

例

次のコードは、ADO.NET のテクノロジに基づいている DDEX プロバイダーで一般的に定義された InvariantName のプロパティの値を取得する方法を説明します。このプロパティの値は、DbProviderFactory API によって ADO.NET 接続オブジェクトを作成するために使用されます。

using System;
using System.Data;
using System.Data.Common;
using Microsoft.VisualStudio.Data.Core;

public class DDEX_IVsDataProviderExample4
{
    public static DbConnection CreateAdoDotNetConnection(
        IVsDataProvider provider)
    {
        string invariantName = provider.GetProperty("InvariantName") as string;
        if (invariantName != null)
        {
            DbProviderFactory factory = DbProviderFactories.GetFactory(
                invariantName);
            if (factory != null)
            {
                return factory.CreateConnection();
            }
        }
        return null;
    }
}

.NET Framework セキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。

参照

関連項目

IVsDataProvider インターフェイス

Microsoft.VisualStudio.Data.Core 名前空間