通过

IVsDataSource.DisplayName 属性

获取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

function get DisplayName () : String

属性值

类型：System.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 安全性

请参见

参考

IVsDataSource 接口

Microsoft.VisualStudio.Data.Core 命名空间