共用方式為

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

    要擷取的屬性名稱。

傳回值

類型：Object
屬性的值，則為，如果存在;則為，否則為 nullnull 參考 (即 Visual Basic 中的 Nothing)。

例外狀況

例外狀況 條件
ArgumentNullException

name 參數為 nullnull 參考 (即 Visual Basic 中的 Nothing)。

備註

DDEX 提供者可以註冊 DDEX 用戶端可以存取決定提供者相關資訊的屬性集。 標準屬性包含提供者名稱、顯示名稱、簡短的顯示名稱、描述和技術，不過，任何屬性可能由提供者中。

屬性值可以開啟 DDEX 提供者的根登錄機碼和要求具有指定之名稱的機碼的值擷取。(根登錄機碼位於 DataProviders 索引鍵下 Visual Studio 區域登錄區)。在特定屬性要求後，它的值在記憶體中保存在 DDEX 執行階段並不會重新整理，直到 Visual Studio 重新啟動。

範例

下列程式碼示範如何擷取 InvariantName 屬性的值，通常是 DDEX 提供者定義是以 ADO.NET 技術。 這個屬性的值會用來傳遞 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 命名空間