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)。
例外狀況
例外狀況 | 條件 |
---|---|
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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。