Metodo IVsDataProvider.GetString
Ottiene una stringa localizzata dal provider di DDEX.
Spazio dei nomi: Microsoft.VisualStudio.Data.Core
Assembly: Microsoft.VisualStudio.Data.Core (in Microsoft.VisualStudio.Data.Core.dll)
Sintassi
'Dichiarazione
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
Parametri
resourceId
Tipo: StringL'identificatore della risorsa di tipo stringa da recuperare.
Valore restituito
Tipo: String
Il valore localizzato della risorsa di tipo stringa, se gli ID di risorsa è valido e identifica una risorsa esistente; in caso contrario, nullriferimento null (Nothing in Visual Basic).
Eccezioni
Eccezione | Condizione |
---|---|
ArgumentNullException | Il parametro resourceId è nullriferimento null (Nothing in Visual Basic). |
Note
Un provider di DDEX può esporre varia ID risorsa per le stringhe localizzate, ad esempio un nome visualizzato e la descrizione. Questo ID della risorsa viene eseguito da client di DDEX che cerca quindi nell'effettiva stringa localizzata chiamando il metodo.
Un ID di risorsa del provider di DDEX può verificarsi in due form. Il primo consente di cercare stringhe di risorsa gestita e ha il formato Nome,Risorsa[,Assembly]. Di seguito è riportato un esempio di un ID di risorsa nel seguente formato: SqlProvider_DisplayName, MyResources, MyAssembly. GetString analizzare le stringhe di risorsa e chiama il metodo GetAssembly per risolvere qualsiasi assembly specificato nella stringa. Il secondo form consente di trovare stringhe di risorsa in pacchetti e ha il formato #nnnn dove nnnn è l'intero ID di risorsa nel pacchetto. Un esempio di un ID di risorsa in questo form viene #3021. Il secondo modulo è meno comune e si applica solo quando il provider di DDEX pacchetto è basato.
Esempi
Il codice seguente viene illustrato come recuperare manualmente il nome visualizzato di un provider di 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;
}
}
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per altre informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.