IVsDataProvider.GetString-Methode
Ruft eine lokalisierte Zeichenfolge vom DDEX-Anbieter ab.
Namespace: Microsoft.VisualStudio.Data.Core
Assembly: Microsoft.VisualStudio.Data.Core (in Microsoft.VisualStudio.Data.Core.dll)
Syntax
'Declaration
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
Parameter
resourceId
Typ: StringDer Bezeichner der Zeichenfolgenressource abzurufen.
Rückgabewert
Typ: String
Der lokalisierte Wert der Zeichenfolgenressource, wenn die ID der Ressource gültig und eine vorhandene Ressource identifiziert; andernfalls nullein Nullverweis (Nothing in Visual Basic).
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | Der resourceId-Parameter ist nullein Nullverweis (Nothing in Visual Basic). |
Hinweise
Ein DDEX-Anbieter kann verschiedene Ressourcen-IDs für lokalisierte Zeichenfolgen, z einen Anzeigenamen und eine Beschreibung verfügbar machen. Auf diese Ressourcen-IDs werden von DDEX-Clients zugegriffen, die dann oben die tatsächliche lokalisierten Zeichenfolge überprüfen, indem sie diese Methode aufrufen.
Eine DDEX-Anbieter-Ressourcen-ID kann in zwei Formen stammen. Das erste können verwaltete Ressourcenzeichenfolgen nachschlagen und besitzt das Format Name, Ressource [, Assembly]. Ein Beispiel für eine Ressourcen-ID in dieser Form: SqlProvider_DisplayName, MyResources, MyAssembly. GetString analysiert die Ressourcenzeichenfolgen und ruft die Methode GetAssembly auf, um jede Assembly aufzulösen, die in der Zeichenfolge angegeben wird. Das zweite Format ermöglicht Ressourcenzeichenfolgen in Paketen nachschlagen und besitzt das Format #nnnn, wobei nnnn die ganzzahlige ID der Ressource im Paket ist. Ein Beispiel einer Ressourcen-ID in dieser Form ist #3021. Das zweite Format ist seltener und gilt nur, wenn der DDEX-Anbieter abfragebasierte das Paket ist.
Beispiele
Der folgende Code zeigt, wie Sie manuell den Anzeigenamen eines DDEX-Anbieters abruft.
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-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.