IVsDataSource.DisplayName (Propiedad)

Artículo
05/17/2015

获取数据源 DDEX 的显示名称。

Espacio de nombres: Microsoft.VisualStudio.Data.Core
Ensamblado: Microsoft.VisualStudio.Data.Core (en Microsoft.VisualStudio.Data.Core.dll)

Sintaxis

'Declaración
ReadOnly Property DisplayName As String

string DisplayName { get; }

property String^ DisplayName {
    String^ get ();
}

abstract DisplayName : string with get

function get DisplayName () : String

Valor de propiedad

Tipo: String
DDEX 数据源的显示名称。

Comentarios

DDEX 数据源的名称是显示可由最终用户的 DDEX 客户显示的已本地化字符串。这种情况的一个例子。数据连接 选择数据源 对话框时，DDEX 数据源及提供程序用户选择。

此属性通过调用 GetProperty 方法确定显示名称，将支持提供程序的默认 (如果有) 和一个参数 DisplayName，检索字符串资源 ID. 如果失败，的属性通过支持提供程序开始循环访问查询，每个的属性，直到非 Null 返回值。然后调用 GetString 方法以检索与 . 资源 ID 的本地化字符串。如果资源不存在，IVsDataSource.Name 属性的返回值。

此属性的一个示例则该值可能是“Microsoft SQL Server”。

Ejemplos

下面的代码演示 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;
    }
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

IVsDataSource Interfaz

Microsoft.VisualStudio.Data.Core (Espacio de nombres)

Compartir a través de