IVsDataSource.DisplayName (Propiedad)

Obtiene el nombre para mostrar del origen de datos de 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

function get DisplayName () : String

Valor de propiedad

Tipo: System.String
El nombre para mostrar del origen de datos de DDEX.

Comentarios

El nombre para mostrar de un origen de datos de DDEX es una cadena traducida que se puede mostrar por los clientes de DDEX a los usuarios finales.Un ejemplo de esto aparece en el cuadro de diálogo Elegir origen de datos de la conexión de datos, donde un origen de datos y el proveedor de DDEX están seleccionados por el usuario.

Esta propiedad determina el nombre para mostrar llamando al método de GetProperty , pasando el proveedor que admite predeterminado (si hay alguno) y el parámetro DisplayName, para recuperar un identificador de recurso de cadenaSi da error, la propiedad simplemente inicia recorrer en iteración los proveedores que admiten, para consultar cada uno para la misma propiedad hasta que se devuelve un valor NULL.Llama al método de GetString para recuperar la cadena adaptada asociado al identificador de recursosSi no existe ningún recurso, el valor de la propiedad de IVsDataSource.Name se devuelve.

Un valor de ejemplo para esta propiedad podría ser “Microsoft SQL Server”.

Ejemplos

El código siguiente muestra la implementación de la propiedad de DisplayName .Dado que las cadenas localizadas proporciona solo admiten los proveedores, determina un proveedor que admite adecuado al usar según el proveedor predeterminado o que los proveedores proporciona valores para la propiedad de DisplayName .A continuación se resuelve esto a la cadena adaptada real mediante la API de proveedor de DDEX.

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)