ResourceManager.GetString Méthode

Définition

Espace de noms:: System.Resources

Assemblys:: mscorlib.dll, System.Resources.ResourceManager.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.Resources.ResourceManager.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Retourne la ressource de chaîne spécifiée pour la culture spécifiée ou la culture actuelle de l’interface utilisateur.

Surcharges

Nom	Description
GetString(String)	Retourne la valeur de la ressource de chaîne spécifiée.
GetString(String, CultureInfo)	Retourne la valeur de la ressource de chaîne localisée pour la culture spécifiée.

GetString(String)

Source:: ResourceManager.cs

Source:: ResourceManager.cs

Source:: ResourceManager.cs

Source:: ResourceManager.cs

Source:: ResourceManager.cs

Retourne la valeur de la ressource de chaîne spécifiée.

public:
 System::String ^ GetString(System::String ^ name);

public:
 virtual System::String ^ GetString(System::String ^ name);

public string GetString(string name);

public virtual string? GetString(string name);

public virtual string GetString(string name);

member this.GetString : string -> string

abstract member GetString : string -> string
override this.GetString : string -> string

Public Function GetString (name As String) As String

Public Overridable Function GetString (name As String) As String

Paramètres

name: String

Nom de la ressource à récupérer.

Retours

String

Valeur de la ressource localisée pour la culture actuelle de l’interface utilisateur de l’appelant, ou null si name elle est introuvable dans un jeu de ressources.

Exceptions

ArgumentNullException

Le name paramètre est null.

InvalidOperationException

La valeur de la ressource spécifiée n’est pas une chaîne.

MissingManifestResourceException

Aucun ensemble utilisable de ressources n’a été trouvé et aucune ressource n’est disponible pour la culture par défaut. Pour plus d’informations sur la gestion de cette exception, consultez la section « Gestion des exceptions MissingManifestResourceException et MissingSatelliteAssemblyException » dans la rubrique de classe ResourceManager .

MissingSatelliteAssemblyException

Les ressources de la culture par défaut résident dans un assembly satellite introuvable. Pour plus d’informations sur la gestion de cette exception, consultez la section « Gestion des exceptions MissingManifestResourceException et MissingSatelliteAssemblyException » dans la rubrique de classe ResourceManager .

Remarques

La propriété IgnoreCase détermine si la comparaison de name avec les noms de ressources est insensible à la casse (valeur par défaut) ou non.

Note

Les GetString méthodes peuvent lever plus d’exceptions que celles répertoriées. Une raison pour laquelle cela peut se produire est si une méthode appelée par cette méthode génère une exception. Par exemple, une FileLoadException exception peut être levée si une erreur a été effectuée lors du déploiement ou de l’installation d’un assembly satellite, ou une SerializationException exception peut être levée si un type défini par l’utilisateur lève une exception définie par l’utilisateur lorsque le type est désérialisé.

méthode GetString(String)

Applications de bureau

Dans les applications de bureau, la ressource renvoyée est localisée pour la culture de l’interface utilisateur du thread actuel, comme définie par la propriété CultureInfo.CurrentUICulture. Si la ressource n’a pas été localisée pour cette culture, le gestionnaire de ressources sonde une ressource en suivant les étapes décrites dans la section « Processus de secours des ressources » de l’article Empaquetage et déploiement de ressources . Si aucun ensemble utilisable de ressources localisées n’est trouvé, le gestionnaire de ressources revient sur les ressources de la culture par défaut. Si le gestionnaire de ressources ne parvient pas à charger l’ensemble de ressources de la culture par défaut, la méthode génère une exception MissingManifestResourceException ou une exception MissingSatelliteAssemblyException (si l’ensemble de ressources est censé se trouver dans un assembly satellite). Si le gestionnaire de ressources peut charger un jeu de ressources approprié, mais qu’il ne trouve pas de ressource nommée name, la méthode retourne null.

Exemple

L'exemple suivant utilise la méthode GetString pour récupérer des ressources spécifiques à la culture. Il se compose de ressources compilées à partir de fichiers .txt pour les cultures anglaise (en), française (France) (fr-FR) et russe (Russie) (ru-RU). L’exemple modifie la culture actuelle et la culture actuelle de l’interface utilisateur en anglais (États-Unis), français (France), Russe (Russie) et Suédois (Suède). Il appelle ensuite la GetString méthode pour récupérer la chaîne localisée, qu’elle affiche avec le jour et le mois actuels. Notez que la sortie affiche la chaîne localisée appropriée, sauf lorsque la culture actuelle de l’interface utilisateur est suédoise (Suède). Étant donné que les ressources de langue suédoise ne sont pas disponibles, l’application utilise plutôt les ressources de la culture par défaut, qui est l’anglais. L’exemple nécessite les fichiers de ressources textuels répertoriés dans le tableau suivant. Chacun a une ressource de chaîne unique nommée DateStart.

Culture	Nom de fichier	Nom de la ressource	Valeur de la ressource
en-US	DateStrings.txt	`DateStart`	Aujourd’hui est
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Aujourd’hui, c’est le
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

Vous pouvez utiliser le fichier batch suivant pour compiler l’exemple C#. Pour Visual Basic, changez csc en vbc, et changez l'extension du fichier de code source de .cs à .vb.

resgen DateStrings.txt
csc showdate.cs /resource:DateStrings.resources

md fr-FR
resgen DateStrings.fr-FR.txt
al /out:fr-FR\Showdate.resources.dll /culture:fr-FR /embed:DateStrings.fr-FR.resources

md ru-RU
resgen DateStrings.ru-RU.txt
al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.resources

Voici le code source de l’exemple (ShowDate.vb pour la version visual Basic ou ShowDate.cs pour la version C#).

using System;
using System.Globalization;
using System.Resources;
using System.Threading;

public class ShowTimeExample
{
   public static void Main()
   {
      string[] cultureNames = [ "en-US", "fr-FR", "ru-RU", "sv-SE" ];
      ResourceManager rm = new ResourceManager("DateStrings",
                                               typeof(Example).Assembly);

      foreach (var cultureName in cultureNames) {
         CultureInfo culture = CultureInfo.CreateSpecificCulture(cultureName);
         Thread.CurrentThread.CurrentCulture = culture;
         Thread.CurrentThread.CurrentUICulture = culture;

         Console.WriteLine($"Current UI Culture: {CultureInfo.CurrentUICulture.Name}");
         string dateString = rm.GetString("DateStart");
         Console.WriteLine($"{dateString} {DateTime.Now:M}.\n");
      }
   }
}

// The example displays output similar to the following:
//       Current UI Culture: en-US
//       Today is February 03.
//
//       Current UI Culture: fr-FR
//       Aujourd'hui, c'est le 3 février
//
//       Current UI Culture: ru-RU
//       Сегодня февраля 03.
//
//       Current UI Culture: sv-SE
//       Today is den 3 februari.

Imports System.Globalization
Imports System.Resources
Imports System.Threading

<Assembly:NeutralResourcesLanguage("en")>

Module Example
   Public Sub Main()
      Dim cultureNames() As String = { "en-US", "fr-FR", "ru-RU", "sv-SE" }
      Dim rm As New ResourceManager("DateStrings",
                                    GetType(Example).Assembly)
      
      For Each cultureName In cultureNames
         Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture(cultureName)
         Thread.CurrentThread.CurrentCulture = culture 
         Thread.CurrentThread.CurrentUICulture = culture

         Console.WriteLine("Current UI Culture: {0}", 
                           CultureInfo.CurrentUICulture.Name)
         Dim dateString As String = rm.GetString("DateStart")
         Console.WriteLine("{0} {1:M}.", dateString, Date.Now)                           
         Console.WriteLine()
      Next                                           
   End Sub
End Module
' The example displays output similar to the following:
'       Current UI Culture: en-US
'       Today is February 03.
'       
'       Current UI Culture: fr-FR
'       Aujourd'hui, c'est le 3 février
'       
'       Current UI Culture: ru-RU
'       Сегодня февраля 03.
'       
'       Current UI Culture: sv-SE
'       Today is den 3 februari.

méthode GetString(String, CultureInfo)

Applications de bureau

Dans les applications de bureau, si culture est null, la méthode GetString(String, CultureInfo) utilise la culture actuelle de l'interface utilisateur obtenue à partir de la propriété CultureInfo.CurrentUICulture.

La ressource retournée est localisée pour la culture spécifiée par le culture paramètre. Si la ressource n’a pas été localisée pour culture, le gestionnaire de ressources recherche une ressource en suivant les étapes décrites dans la section « Processus de secours des ressources » de la rubrique Empaquetage et déploiement de ressources. Si aucun ensemble de ressources utilisable n’est trouvé, le gestionnaire de ressources revient sur les ressources de la culture par défaut. Si le gestionnaire de ressources ne parvient pas à charger l’ensemble de ressources de la culture par défaut, la méthode génère une exception MissingManifestResourceException ou une exception MissingSatelliteAssemblyException (si l’ensemble de ressources est censé se trouver dans un assembly satellite). Si le gestionnaire de ressources peut charger un jeu de ressources approprié, mais qu’il ne trouve pas de ressource nommée name, la méthode retourne null.

Exemple

L'exemple suivant utilise la méthode GetString(String, CultureInfo) pour récupérer des ressources spécifiques à la culture. La culture par défaut de l’exemple est l’anglais (en) et inclut des assemblys satellites pour les cultures françaises (France) (fr-FR) et russe (Russie) (ru-RU). L’exemple modifie la culture actuelle et la culture actuelle de l’interface utilisateur en Russe (Russie) avant d’appeler GetString(String, CultureInfo). Il appelle ensuite la GetString méthode et la DateTime.ToString(String, IFormatProvider) méthode et transmet des CultureInfo objets qui représentent les cultures françaises (France) et suédoise (Suède) à chaque méthode. Dans la sortie, le mois et le jour du mois ainsi que la chaîne qui les précède apparaissent en français, car la GetString méthode est en mesure de récupérer la ressource de langue française. Toutefois, lorsque la culture suédoise (Suède) est utilisée, le mois et le jour du mois apparaissent en suédois, bien que la chaîne qui les précède soit en anglais. Cela est dû au fait que le gestionnaire de ressources ne trouve pas les ressources de langue suédoise localisées. Il retourne donc une ressource pour la culture anglaise par défaut.

L’exemple nécessite les fichiers de ressources textuels répertoriés dans le tableau suivant. Chacun a une ressource de chaîne unique nommée DateStart.

Culture	Nom de fichier	Nom de la ressource	Valeur de la ressource
en-US	DateStrings.txt	`DateStart`	Aujourd’hui est
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Aujourd’hui, c’est le
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

Vous pouvez utiliser le fichier batch suivant pour compiler l’exemple Visual Basic. Pour compiler en C#, modifiez vbc à csc et changez l'extension du fichier de code source de .vb à .cs.

resgen DateStrings.txt
vbc showdate.vb /resource:DateStrings.resources

md fr-FR
resgen DateStrings.fr-FR.txt
al /out:fr-FR\Showdate.resources.dll /culture:fr-FR /embed:DateStrings.fr-FR.resources

md ru-RU
resgen DateStrings.ru-RU.txt
al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.resources

Voici le code source de l’exemple (ShowDate.vb pour la version visual Basic ou ShowDate.cs pour la version C#).

using System;
using System.Globalization;
using System.Resources;
using System.Threading;

public class Example2
{
    public static void Main()
    {
        Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("ru-RU");
        Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("ru-RU");

        string[] cultureNames = [ "fr-FR", "sv-SE" ];
        ResourceManager rm = new ResourceManager("DateStrings",
                                                 typeof(Example).Assembly);

        foreach (var cultureName in cultureNames)
        {
            CultureInfo culture = CultureInfo.CreateSpecificCulture(cultureName);
            string dateString = rm.GetString("DateStart", culture);
            Console.WriteLine($"{culture.DisplayName}: {dateString} {DateTime.Now.ToString("M", culture)}.");
            Console.WriteLine();
        }
    }
}

// The example displays output similar to the following:
//       French (France): Aujourd'hui, c'est le 7 février.
//
//       Swedish (Sweden): Today is den 7 februari.

Imports System.Globalization
Imports System.Resources
Imports System.Threading

Module Example2
    Public Sub Main()
        Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("ru-RU")
        Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("ru-RU")

        Dim cultureNames() As String = {"fr-FR", "sv-SE"}
        Dim rm As New ResourceManager("DateStrings",
                                    GetType(Example).Assembly)

        For Each cultureName In cultureNames
            Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture(cultureName)
            Dim dateString As String = rm.GetString("DateStart", culture)
            Console.WriteLine("{0}: {1} {2}.", culture.DisplayName, dateString,
                                            Date.Now.ToString("M", culture))
            Console.WriteLine()
        Next
    End Sub
End Module
' The example displays output similar to the following:
'       French (France): Aujourd'hui, c'est le 7 février.
'       
'       Swedish (Sweden): Today is den 7 februari.

Cohérence de thread

La GetString(String) méthode est thread safe.

Voir aussi

S’applique à

GetString(String, CultureInfo)

Source:: ResourceManager.cs

Source:: ResourceManager.cs

Source:: ResourceManager.cs

Source:: ResourceManager.cs

Source:: ResourceManager.cs

Retourne la valeur de la ressource de chaîne localisée pour la culture spécifiée.

public:
 virtual System::String ^ GetString(System::String ^ name, System::Globalization::CultureInfo ^ culture);

public virtual string GetString(string name, System.Globalization.CultureInfo culture);

public virtual string? GetString(string name, System.Globalization.CultureInfo? culture);

abstract member GetString : string * System.Globalization.CultureInfo -> string
override this.GetString : string * System.Globalization.CultureInfo -> string

Public Overridable Function GetString (name As String, culture As CultureInfo) As String

Paramètres

name: String

Nom de la ressource à récupérer.

culture: CultureInfo

Objet qui représente la culture pour laquelle la ressource est localisée.

Retours

String

Valeur de la ressource localisée pour la culture spécifiée ou null si name elle est introuvable dans un jeu de ressources.

Exceptions

ArgumentNullException

Le name paramètre est null.

InvalidOperationException

La valeur de la ressource spécifiée n’est pas une chaîne.

MissingManifestResourceException

Aucun ensemble utilisable de ressources n’a été trouvé et aucune ressource n’est disponible pour une culture par défaut. Pour plus d’informations sur la gestion de cette exception, consultez la section « Gestion des exceptions MissingManifestResourceException et MissingSatelliteAssemblyException » dans la rubrique de classe ResourceManager .

MissingSatelliteAssemblyException

Remarques

La propriété IgnoreCase détermine si la comparaison de name avec les noms de ressources est insensible à la casse (valeur par défaut) ou non.

Note

méthode GetString(String)

Applications de bureau

Exemple

Culture	Nom de fichier	Nom de la ressource	Valeur de la ressource
en-US	DateStrings.txt	`DateStart`	Aujourd’hui est
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Aujourd’hui, c’est le
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

Vous pouvez utiliser le fichier batch suivant pour compiler l’exemple C#. Pour Visual Basic, changez csc en vbc, et changez l'extension du fichier de code source de .cs à .vb.

resgen DateStrings.txt
csc showdate.cs /resource:DateStrings.resources

md fr-FR
resgen DateStrings.fr-FR.txt
al /out:fr-FR\Showdate.resources.dll /culture:fr-FR /embed:DateStrings.fr-FR.resources

md ru-RU
resgen DateStrings.ru-RU.txt
al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.resources

Voici le code source de l’exemple (ShowDate.vb pour la version visual Basic ou ShowDate.cs pour la version C#).

using System;
using System.Globalization;
using System.Resources;
using System.Threading;

public class ShowTimeExample
{
   public static void Main()
   {
      string[] cultureNames = [ "en-US", "fr-FR", "ru-RU", "sv-SE" ];
      ResourceManager rm = new ResourceManager("DateStrings",
                                               typeof(Example).Assembly);

      foreach (var cultureName in cultureNames) {
         CultureInfo culture = CultureInfo.CreateSpecificCulture(cultureName);
         Thread.CurrentThread.CurrentCulture = culture;
         Thread.CurrentThread.CurrentUICulture = culture;

         Console.WriteLine($"Current UI Culture: {CultureInfo.CurrentUICulture.Name}");
         string dateString = rm.GetString("DateStart");
         Console.WriteLine($"{dateString} {DateTime.Now:M}.\n");
      }
   }
}

// The example displays output similar to the following:
//       Current UI Culture: en-US
//       Today is February 03.
//
//       Current UI Culture: fr-FR
//       Aujourd'hui, c'est le 3 février
//
//       Current UI Culture: ru-RU
//       Сегодня февраля 03.
//
//       Current UI Culture: sv-SE
//       Today is den 3 februari.

Imports System.Globalization
Imports System.Resources
Imports System.Threading

<Assembly:NeutralResourcesLanguage("en")>

Module Example
   Public Sub Main()
      Dim cultureNames() As String = { "en-US", "fr-FR", "ru-RU", "sv-SE" }
      Dim rm As New ResourceManager("DateStrings",
                                    GetType(Example).Assembly)
      
      For Each cultureName In cultureNames
         Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture(cultureName)
         Thread.CurrentThread.CurrentCulture = culture 
         Thread.CurrentThread.CurrentUICulture = culture

         Console.WriteLine("Current UI Culture: {0}", 
                           CultureInfo.CurrentUICulture.Name)
         Dim dateString As String = rm.GetString("DateStart")
         Console.WriteLine("{0} {1:M}.", dateString, Date.Now)                           
         Console.WriteLine()
      Next                                           
   End Sub
End Module
' The example displays output similar to the following:
'       Current UI Culture: en-US
'       Today is February 03.
'       
'       Current UI Culture: fr-FR
'       Aujourd'hui, c'est le 3 février
'       
'       Current UI Culture: ru-RU
'       Сегодня февраля 03.
'       
'       Current UI Culture: sv-SE
'       Today is den 3 februari.

méthode GetString(String, CultureInfo)

Applications de bureau

Exemple

L’exemple nécessite les fichiers de ressources textuels répertoriés dans le tableau suivant. Chacun a une ressource de chaîne unique nommée DateStart.

Culture	Nom de fichier	Nom de la ressource	Valeur de la ressource
en-US	DateStrings.txt	`DateStart`	Aujourd’hui est
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Aujourd’hui, c’est le
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

Vous pouvez utiliser le fichier batch suivant pour compiler l’exemple Visual Basic. Pour compiler en C#, modifiez vbc à csc et changez l'extension du fichier de code source de .vb à .cs.

resgen DateStrings.txt
vbc showdate.vb /resource:DateStrings.resources

md fr-FR
resgen DateStrings.fr-FR.txt
al /out:fr-FR\Showdate.resources.dll /culture:fr-FR /embed:DateStrings.fr-FR.resources

md ru-RU
resgen DateStrings.ru-RU.txt
al /out:ru-RU\Showdate.resources.dll /culture:ru-RU /embed:DateStrings.ru-RU.resources

Voici le code source de l’exemple (ShowDate.vb pour la version visual Basic ou ShowDate.cs pour la version C#).

using System;
using System.Globalization;
using System.Resources;
using System.Threading;

public class Example2
{
    public static void Main()
    {
        Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("ru-RU");
        Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("ru-RU");

        string[] cultureNames = [ "fr-FR", "sv-SE" ];
        ResourceManager rm = new ResourceManager("DateStrings",
                                                 typeof(Example).Assembly);

        foreach (var cultureName in cultureNames)
        {
            CultureInfo culture = CultureInfo.CreateSpecificCulture(cultureName);
            string dateString = rm.GetString("DateStart", culture);
            Console.WriteLine($"{culture.DisplayName}: {dateString} {DateTime.Now.ToString("M", culture)}.");
            Console.WriteLine();
        }
    }
}

// The example displays output similar to the following:
//       French (France): Aujourd'hui, c'est le 7 février.
//
//       Swedish (Sweden): Today is den 7 februari.

Imports System.Globalization
Imports System.Resources
Imports System.Threading

Module Example2
    Public Sub Main()
        Thread.CurrentThread.CurrentCulture = CultureInfo.CreateSpecificCulture("ru-RU")
        Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture("ru-RU")

        Dim cultureNames() As String = {"fr-FR", "sv-SE"}
        Dim rm As New ResourceManager("DateStrings",
                                    GetType(Example).Assembly)

        For Each cultureName In cultureNames
            Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture(cultureName)
            Dim dateString As String = rm.GetString("DateStart", culture)
            Console.WriteLine("{0}: {1} {2}.", culture.DisplayName, dateString,
                                            Date.Now.ToString("M", culture))
            Console.WriteLine()
        Next
    End Sub
End Module
' The example displays output similar to the following:
'       French (France): Aujourd'hui, c'est le 7 février.
'       
'       Swedish (Sweden): Today is den 7 februari.

Cohérence de thread

La GetString(String, CultureInfo) méthode est thread safe.

Voir aussi

S’applique à

Commentaires

Cette page a-t-elle été utile ?