IVsDataSource.DisplayName – vlastnost

Článek
10/27/2012

Načte zobrazovaný název zdroje dat DDEX.

Obor názvů: Microsoft.VisualStudio.Data.Core
Sestavení: Microsoft.VisualStudio.Data.Core (v Microsoft.VisualStudio.Data.Core.dll)

Syntaxe

'Deklarace
ReadOnly Property DisplayName As String

string DisplayName { get; }

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

abstract DisplayName : string

function get DisplayName () : String

Hodnota vlastnosti

Typ: System.String
Zobrazovaný název zdroje dat DDEX.

Poznámky

Zobrazovaný název zdroje dat DDEX je lokalizovaný řetězec zobrazený klienty DDEX koncovým uživatelům.Jedním příkladem dochází v datovém připojení Zvolit zdroj dat dialogové okno, kde zdroj dat DDEX a poskytovatele vybrané uživatelem.

Tato vlastnost určuje zobrazovaný název voláním GetProperty metodu výchozí zprostředkovatel (pokud existuje) a parametr DisplayName , načíst číslo ID zdroje řetězce.Pokud se to nezdaří, spustí vlastnost právě iterace podpůrné zprostředkovatelů, každý pro stejnou vlastnost dotazování, dokud není vrácena nenulovou hodnotu.Pak zavolá GetString metodu načtení lokalizovaný řetězec, který je spojen s ID zdroje.Pokud neexistuje žádný prostředek, hodnota IVsDataSource.Name vlastnost je vrácena.

Například hodnota této vlastnosti může být "Microsoft SQL Server".

Příklady

Následující kód ukazuje provádění DisplayName vlastnost.Protože lokalizovaných řetězců jsou poskytovány pouze podporou zprostředkovatelů, určuje podle poskytovatele odpovídající podpůrné použití výchozího poskytovatele nebo poskytovatelů dodávat hodnoty DisplayName vlastnost.Se potom převádí tento skutečné lokalizovaných řetězců pomocí zprostředkovatele 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;
    }
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

IVsDataSource Rozhraní

Microsoft.VisualStudio.Data.Core – obor názvů

Sdílet prostřednictvím