获取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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。