IVsDataProvider.GetString 方法
從 DDEX 提供者取得當地語系化字串。
命名空間： Microsoft.VisualStudio.Data.Core
組件： Microsoft.VisualStudio.Data.Core (在 Microsoft.VisualStudio.Data.Core.dll 中)
語法
'宣告
Function GetString ( _
resourceId As String _
) As String
string GetString(
string resourceId
)
String^ GetString(
String^ resourceId
)
abstract GetString :
resourceId:string -> string
function GetString(
resourceId : String
) : String
參數
resourceId
類型：String擷取字串資源的識別項。
傳回值
類型：String
字串資源的當地語系化值，則為，如果資源 ID 有效並識別現有資源;則為，否則為 nullnull 參考 (即 Visual Basic 中的 Nothing)。
例外狀況
| 例外狀況 | 條件 |
|---|---|
| ArgumentNullException | resourceId 參數為 nullnull 參考 (即 Visual Basic 中的 Nothing)。 |
備註
DDEX 提供者可以公開的當地語系化字串的各種資源 ID，如顯示名稱和描述。 這些資源 ID 是藉由呼叫這個方法會搜尋實際當地語系化字串 DDEX 用戶端存取。
DDEX 提供者資源 ID 可能有兩種形式。 第一個可搜尋 Managed 資源字串的格式為 名稱,資源[,組件]。 下列資源 ID 的範例以這種形式: SqlProvider_DisplayName, MyResources, MyAssembly。 GetString 解析資源字串並呼叫 GetAssembly 方法剖析字串中指定的所有組件。 第二個表單啟用搜尋在封裝的資源字串，其格式為 #nnnnnnnn 是資源的整數 ID 在套件的位置。 資源 ID 的範例以這種形式是 #3021。 只有在 DDEX 提供者是封裝架構時，第二個表單少見並套用。
範例
下列程式碼示範如何手動擷取 DDEX 提供者的顯示名稱。
using System;
using Microsoft.VisualStudio.Data.Core;
public class DDEX_IVsDataProviderExample5
{
public static string GetDisplayName(
IVsDataProvider provider)
{
string displayName = String.Empty;
string resourceId = provider.GetProperty("DisplayName") as string;
if (resourceId != null)
{
displayName = provider.GetString(resourceId);
}
return displayName;
}
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。