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 with get
function get DisplayName () : String
屬性值
類型：String
DDEX 資料來源的顯示名稱。
備註
DDEX 資料來源的顯示名稱是使用者的 DDEX 用戶端顯示的當地語系化字串。 這個範例在資料連接的 [選取資料來源] 對話方塊中， DDEX 資料來源和提供者是由使用者選取。
這個屬性是透過呼叫 GetProperty 方法判斷顯示名稱，可以在支援提供者的預設值 (如果有的話) 和 DisplayName參數，擷取字串資源 ID. 如果失敗，屬性開始逐一查看支援的提供者，查詢每個相同屬性的，直到非 null 值。 然後它會呼叫 GetString 方法來擷取與資源 ID. 的當地語系化字串。 如果資源不存在， IVsDataSource.Name 屬性的值。
這個屬性的範例值可能是「Microsoft SQL Server」。
範例
下列程式碼示範 DisplayName 屬性的實作。 因為支援提供者只提供當地語系化字串，它會判斷適當的支援的提供者會根據和/或提供者的 DisplayName 屬性值的預設提供者的用途。 使用 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;
}
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。