IVsDataSource.DisplayName, propriété

Article
11/15/2012

Obtient le nom complet de la source de données de DDEX.

Espace de noms : Microsoft.VisualStudio.Data.Core
Assembly : Microsoft.VisualStudio.Data.Core (dans Microsoft.VisualStudio.Data.Core.dll)

Syntaxe

'Déclaration
ReadOnly Property DisplayName As String

string DisplayName { get; }

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

abstract DisplayName : string

function get DisplayName () : String

Valeur de propriété

Type : System.String
Le nom complet de la source de données de DDEX.

Notes

Le nom complet d'une source de données de DDEX est une chaîne localisée qui peut être affichée par les clients de DDEX aux utilisateurs finaux.Un exemple de cela se produit dans la boîte de dialogue Choisir la source de données de connexion de données, où une source de données et le fournisseur de DDEX sont sélectionnés par l'utilisateur.

Cette propriété détermine le nom complet en appelant la méthode d' GetProperty , en passant le fournisseur qui prend en charge par défaut (le cas échéant) et le paramètre DisplayName, récupérer un ID de ressource de type chaîneDans ce cas, la propriété commence juste d'itérer au sein de les fournisseurs de prise en charge, interrogeant la fois pour la même propriété jusqu'à ce qu'une valeur non null est retournée.Il appelle ensuite la méthode d' GetString pour récupérer la chaîne localisée qui est associée à l'ID de ressourceSi aucune ressource n'existe, la valeur de la propriété d' IVsDataSource.Name est retournée.

Une valeur d'exemple pour cette propriété peut être « Microsoft SQL Server ».

Exemples

Le code suivant illustre l'implémentation de la propriété d' DisplayName .Étant donné que les chaînes localisées sont fournies uniquement en prenant en charge les fournisseurs, il détermine un fournisseur qui prend en charge approprié à utiliser selon le fournisseur par défaut et/ou que les fournisseurs -vous des valeurs pour la propriété d' DisplayName .Il résout ensuite faire à la chaîne localisée réelle à l'aide de l'API fournisseur 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;
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

IVsDataSource Interface

Microsoft.VisualStudio.Data.Core, espace de noms

Partager via