获取数据源 DDEX 的显示名称。
命名空间： Microsoft.VisualStudio.Data.Core
程序集： Microsoft.VisualStudio.Data.Core（在 Microsoft.VisualStudio.Data.Core.dll 中）
语法
声明
ReadOnly Property DisplayName As String
string DisplayName { get; }
property String^ DisplayName {
String^ get ();
}
abstract DisplayName : string with get
function get DisplayName () : String
属性值
类型：String
DDEX 数据源的显示名称。
备注
DDEX 数据源的名称是显示可由最终用户的 DDEX 客户显示的已本地化字符串。 这种情况的一个例子。数据连接 选择数据源 对话框时，DDEX 数据源及提供程序用户选择。
此属性通过调用 GetProperty 方法确定显示名称，将支持提供程序的默认 (如果有) 和一个参数 DisplayName，检索字符串资源 ID. 如果失败，的属性通过支持提供程序开始循环访问查询，每个的属性，直到非 Null 返回值。 然后调用 GetString 方法以检索与 . 资源 ID 的本地化字符串。 如果资源不存在，IVsDataSource.Name 属性的返回值。
此属性的一个示例则该值可能是“Microsoft SQL Server”。
示例
下面的代码演示 DisplayName 属性的实现。 由于支持提供程序仅提供本地化的字符串一样，它确定相应支持的提供程序以根据和/或提供程序提供 DisplayName 属性的值默认提供程序。 使用 DDEX 提供程序 API，然后解决此为实际的本地化字符串。
using System;
using System.Data;
using System.Data.Common;
using Microsoft.VisualStudio.Data.Core;
public class DDEX_IVsDataSourceExample2
{
public static string GetSourceDisplayName(
IServiceProvider serviceProvider,
IVsDataSource dataSource)
{
string displayName = null;
string resourceId = null;
Guid provider = dataSource.DefaultProvider;
if (provider != Guid.Empty)
{
resourceId = dataSource.GetProperty(provider, "DisplayName") as string;
}
if (resourceId == null)
{
foreach (Guid providerId in dataSource.GetProviders())
{
resourceId = dataSource.GetProperty(
providerId, "DisplayName") as string;
if (resourceId != null)
{
provider = providerId;
break;
}
}
}
if (provider != Guid.Empty && resourceId != null)
{
IVsDataProviderManager providerManager = serviceProvider.GetService(
typeof(IVsDataProviderManager)) as IVsDataProviderManager;
IVsDataProvider dataProvider = providerManager.Providers[provider];
displayName = dataProvider.GetString(resourceId);
}
return displayName;
}
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息，请参阅通过部分受信任的代码使用库。