共用方式為

IVsDataSource.DisplayName 屬性

  • 發行項

取得 DDEX 資料來源的顯示名稱。

命名空間：  Microsoft.VisualStudio.Data.Core
組件：  Microsoft.VisualStudio.Data.Core (在 Microsoft.VisualStudio.Data.Core.dll 中)

語法

'宣告
ReadOnly Property DisplayName As String

string DisplayName { get; }

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

abstract DisplayName : string

function get DisplayName () : String

屬性值

型別：System.String
DDEX 資料來源的顯示名稱。

備註

DDEX 資料來源的顯示名稱是以使用者的 DDEX 用戶端顯示的當地語系化字串。這個範例會在資料連接 [選擇資料來源] 對話方塊時， DDEX 資料來源和提供者是由使用者選取。

這個屬性是透過呼叫方法 GetProperty 判斷顯示名稱，以及可以在支援提供者的預設 (如果有的話) 和參數 DisplayName，擷取字串資源 ID.如果失敗，屬性開始逐一查看支援的提供者，查詢每個相同屬性的，直到非 null 值傳回。然後它會呼叫方法 GetString 擷取與資源 ID. 的當地語系化字串。如果資源不存在， IVsDataSource.Name 會傳回屬性的值。

這個屬性的範例值可能是「Microsoft SQL Server」。

範例

下列程式碼示範 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;
    }
}

.NET Framework 安全性

請參閱

參考

IVsDataSource 介面

Microsoft.VisualStudio.Data.Core 命名空間