IVsDataSource.DisplayName-Eigenschaft

Artikel
05/16/2015

Ruft den Anzeigenamen der DDEX-Datenquelle ab.

Namespace: Microsoft.VisualStudio.Data.Core
Assembly: Microsoft.VisualStudio.Data.Core (in Microsoft.VisualStudio.Data.Core.dll)

Syntax

'Declaration
ReadOnly Property DisplayName As String

string DisplayName { get; }

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

abstract DisplayName : string with get

function get DisplayName () : String

Eigenschaftswert

Typ: String
Der Anzeigename der DDEX-Datenquelle.

Hinweise

Der Anzeigename eines DDEX-Datenquelle ist einer lokalisierten Zeichenfolge, die von DDEX-Clients für Endbenutzer angezeigt werden kann. Ein Beispiel hierfür ist das Datenverbindungsdialogfeld Datenquelle auswählen, in dem eine DDEX-Datenquelle und -Anbieter vom Benutzer ausgewählt werden.

Diese Eigenschaft bestimmt den Anzeigenamen, indem sie die GetProperty-Methode aufruft und den Standard übergibt, der Anbieter unterstützt (sofern vorhanden) und der Parameter DisplayName, um eine Zeichenfolgenressource abzurufen ID Wenn dies fehlschlägt, wird die Eigenschaft nur das Durchlaufen der unterstützenden Anbieter und fragt jedes für dieselbe Eigenschaft ab, bis ein Wert zurückgegeben ist nicht NULL ist. Sie ruft dann die GetString-Methode auf, um die lokalisierte Zeichenfolge abzurufen, die der Ressource ID zugeordnet ist Wenn keine Ressource vorhanden ist, wird der Wert der IVsDataSource.Name-Eigenschaft zurückgegeben.

Ein Beispielswert für diese Eigenschaft kann "Microsoft SQL Server".

Beispiele

Im folgenden Code wird die Implementierung der Eigenschaft DisplayName. Da lokalisierte Zeichenfolgen bereitgestellt werden, werden nur vom Unterstützung von Anbietern, legt er einen entsprechenden unterstützenden Anbieter, um auf Grundlage den Standardanbieter verwenden und/oder den Anbieter Werte für die DisplayName-Eigenschaft angeben. Er löst dann dieses zur tatsächlichen lokalisierten Zeichenfolge auf, indem er die DDEX-Anbieter API verwendet.

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-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

IVsDataSource Schnittstelle

Microsoft.VisualStudio.Data.Core-Namespace

Freigeben über