IVsDataProvider.GetString, méthode

Article
05/16/2015

Obtient une chaîne localisée du fournisseur de DDEX.

Espace de noms : Microsoft.VisualStudio.Data.Core
Assembly : Microsoft.VisualStudio.Data.Core (dans Microsoft.VisualStudio.Data.Core.dll)

Syntaxe

'Déclaration
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

Paramètres

resourceId
Type : String

L'identificateur de la ressource de type chaîne à récupérer.

Valeur de retour

Type : String
La valeur localisée de la ressource de type chaîne, si l'ID de ressource est valide et identifie une ressource existante ; sinon, nullune référence null (Nothing en Visual Basic).

Exceptions

Exception	Condition
ArgumentNullException	Le paramètre resourceId est nullune référence null (Nothing en Visual Basic).

Notes

Un fournisseur de DDEX peut exposer des différents ID de ressource pour les chaînes localisées, comme un nom complet et une description. Ces ID de ressource sont accessibles par les clients de DDEX cette puis recherche la chaîne localisée réelle en appelant cette méthode.

Un ID de ressource de fournisseur de DDEX peut provenir sous deux formes. Le premier active surveiller les chaînes de ressource managée et est au format Nom, Ressource [, assembly]. Voici un exemple d'un ID de ressource sous cette forme : SqlProvider_DisplayName, MyResources, MyAssembly. GetString analyse les chaînes de ressources et appelle la méthode GetAssembly pour résoudre tout assembly spécifié dans la chaîne. Le deuxième formulaire active surveiller les chaînes de ressources dans des packages, et présente le format #NNNN où NNNN est l'ID d'entier de la ressource dans le package. Un exemple d'un ID de ressource sous cette forme est #3021. Le deuxième formulaire est moins courante et applique uniquement lorsque le fournisseur de DDEX est package basé.

Exemples

Le code suivant montre comment récupérer manuellement le nom complet d'un fournisseur de 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;
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, voir Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

IVsDataProvider Interface

Microsoft.VisualStudio.Data.Core, espace de noms

Partager via