ResourceManager.GetString Metod

Definition

Namnområde:: System.Resources

Sammansättningar:: mscorlib.dll, System.Resources.ResourceManager.dll

Sammansättningar:: netstandard.dll, System.Runtime.dll

Sammansättning:: System.Resources.ResourceManager.dll

Sammansättning:: mscorlib.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Returnerar den angivna strängresursen för den angivna kulturen eller den aktuella användargränssnittskulturen.

Överlagringar

Name	Description
GetString(String)	Returnerar värdet för den angivna strängresursen.
GetString(String, CultureInfo)	Returnerar värdet för strängresursen lokaliserad för den angivna kulturen.

GetString(String)

Källa:: ResourceManager.cs

Källa:: ResourceManager.cs

Källa:: ResourceManager.cs

Källa:: ResourceManager.cs

Källa:: ResourceManager.cs

Returnerar värdet för den angivna strängresursen.

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

Parametrar

name: String

Namnet på resursen som ska hämtas.

Returer

String

Värdet för resursen som lokaliserats för anroparens aktuella användargränssnittskultur, eller null om name det inte går att hitta i en resursuppsättning.

Undantag

ArgumentNullException

Parametern name är null.

InvalidOperationException

Värdet för den angivna resursen är inte en sträng.

MissingManifestResourceException

Ingen användbar uppsättning resurser har hittats och det finns inga resurser för standardkulturen. Information om hur du hanterar det här undantaget finns i avsnittet "Hantera MissingManifestResourceException och MissingSatelliteAssemblyException Exceptions" i klassavsnittet ResourceManager .

MissingSatelliteAssemblyException

Standardkulturens resurser finns i en satellitsammansättning som inte kunde hittas. Information om hur du hanterar det här undantaget finns i avsnittet "Hantera MissingManifestResourceException och MissingSatelliteAssemblyException Exceptions" i klassavsnittet ResourceManager .

Kommentarer

Egenskapen IgnoreCase avgör om jämförelsen av name med namnen på resurserna är skiftlägesokänslig (standard) eller skiftlägeskänslig.

Note

Metoderna GetString kan generera fler undantag än vad som visas i listan. En orsak till att detta kan inträffa är om en metod som den här metoden anropar utlöser ett undantag. Ett FileLoadException undantag kan till exempel utlösas om ett fel uppstod vid distribution eller installation av en satellitsammansättning, eller om ett SerializationException undantag kan utlösas om en användardefinierad typ utlöser ett användardefinierat undantag när typen deserialiseras.

GetString(String) metod

Skrivbordsappar

I datorprogram lokaliseras den resurs som returneras för den aktuella trådens användargränssnittskultur, som definieras av egenskapen CultureInfo.CurrentUICulture. Om resursen inte har lokaliserats för den kulturen avsöker resurshanteraren en resurs genom att följa stegen som beskrivs i avsnittet "Resursåterställningsprocess" i artikeln Paketering och distribution av resurser . Om ingen användbar uppsättning lokaliserade resurser hittas återgår resurshanteraren till standardkulturens resurser. Om resurshanteraren inte kan läsa in standardkulturens resursuppsättning utlöser metoden ett MissingManifestResourceException undantag eller, om resursuppsättningen förväntas finnas i en satellitsammansättning, ett MissingSatelliteAssemblyException undantag. Om resurshanteraren kan läsa in en lämplig resursuppsättning men inte kan hitta en resurs med namnet namereturnerar metoden null.

Example

I följande exempel används GetString metoden för att hämta kulturspecifika resurser. Den består av resurser som sammanställts från .txt filer för den engelska (en), franska (Frankrike) (fr-FR), och ryska (Ryssland) (ru-RU) kulturer. Exemplet ändrar den aktuella kulturen och den aktuella användargränssnittskulturen till engelska (USA), franska (Frankrike), ryska (Ryssland) och svenska (Sverige). Sedan anropas GetString metoden för att hämta den lokaliserade strängen, som visas tillsammans med aktuell dag och månad. Observera att utdata visar lämplig lokaliserad sträng utom när den aktuella användargränssnittskulturen är svensk (Sverige). Eftersom svenska språkresurser inte är tillgängliga använder appen i stället resurserna i standardkulturen, som är engelska. Exemplet kräver de textbaserade resursfiler som anges i följande tabell. Var och en har en enskild strängresurs med namnet DateStart.

Kultur	Filnamn	Resursnamn	Resursvärde
en-US	DateStrings.txt	`DateStart`	Idag är
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Idag är det
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

Du kan använda följande batchfil för att kompilera C#-exemplet. För Visual Basic ändrar du csc till vbcoch ändrar filnamnstillägget för källkodsfilen från .cs till .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

Här är källkoden för exemplet (ShowDate.vb för Visual Basic-versionen eller ShowDate.cs för C#-versionen).

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.

GetString(String, CultureInfo) metod

Skrivbordsappar

I skrivbordsappar, om culture är null, GetString(String, CultureInfo) använder metoden den aktuella användargränssnittskulturen som hämtats från CultureInfo.CurrentUICulture egenskapen.

Resursen som returneras lokaliseras för den kultur som anges av parametern culture . Om resursen inte har lokaliserats för cultureavsöker resurshanteraren en resurs genom att följa stegen som beskrivs i avsnittet "Resursåterställningsprocess" i avsnittet Paketering och distribution av resurser . Om ingen användbar uppsättning resurser hittas faller resurshanteraren tillbaka på standardkulturens resurser. Om resurshanteraren inte kan läsa in standardkulturens resursuppsättning utlöser metoden ett MissingManifestResourceException undantag eller, om resursuppsättningen förväntas finnas i en satellitsammansättning, ett MissingSatelliteAssemblyException undantag. Om resurshanteraren kan läsa in en lämplig resursuppsättning men inte kan hitta en resurs med namnet namereturnerar metoden null.

Example

I följande exempel används GetString(String, CultureInfo) metoden för att hämta kulturspecifika resurser. Exemplets standardkultur är engelska (en), och den innehåller satellitsammansättningar för de franska (Frankrike) (fr-FR) och ryska (Ryssland) (ru-RU) kulturer. Exemplet ändrar den aktuella kulturen och den aktuella användargränssnittskulturen till ryska (Ryssland) innan du anropar GetString(String, CultureInfo). Den anropar sedan GetString metoden och DateTime.ToString(String, IFormatProvider) metoden och skickar CultureInfo objekt som representerar de franska (Frankrike) och svenska (Sverige) kulturerna till varje metod. I utdata visas månaden och dagen i månaden samt strängen som föregår dem på franska, eftersom GetString metoden kan hämta den franska språkresursen. Men när den svenska kulturen används visas månaden och dagen i månaden på svenska, även om strängen som föregår dem är på engelska. Det beror på att resurshanteraren inte kan hitta lokaliserade svenska språkresurser, så den returnerar en resurs för den engelska standardkulturen i stället.

Exemplet kräver de textbaserade resursfiler som anges i följande tabell. Var och en har en enskild strängresurs med namnet DateStart.

Kultur	Filnamn	Resursnamn	Resursvärde
en-US	DateStrings.txt	`DateStart`	Idag är
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Idag är det
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

Du kan använda följande batchfil för att kompilera Visual Basic-exemplet. Kompilera i C# genom att ändra vbc till cscoch ändra filnamnstillägget för källkodsfilen från .vb till .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

Här är källkoden för exemplet (ShowDate.vb för Visual Basic-versionen eller ShowDate.cs för C#-versionen).

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.

Trådsäkerhet

Metoden GetString(String) är trådsäker.

Se även

Gäller för

GetString(String, CultureInfo)

Källa:: ResourceManager.cs

Källa:: ResourceManager.cs

Källa:: ResourceManager.cs

Källa:: ResourceManager.cs

Källa:: ResourceManager.cs

Returnerar värdet för strängresursen lokaliserad för den angivna kulturen.

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

Parametrar

name: String

Namnet på resursen som ska hämtas.

culture: CultureInfo

Ett objekt som representerar den kultur som resursen är lokaliserad för.

Returer

String

Värdet för resursen som lokaliserats för den angivna kulturen, eller null om name det inte går att hitta i en resursuppsättning.

Undantag

ArgumentNullException

Parametern name är null.

InvalidOperationException

Värdet för den angivna resursen är inte en sträng.

MissingManifestResourceException

Ingen användbar uppsättning resurser har hittats och det finns inga resurser för en standardkultur. Information om hur du hanterar det här undantaget finns i avsnittet "Hantera MissingManifestResourceException och MissingSatelliteAssemblyException Exceptions" i klassavsnittet ResourceManager .

MissingSatelliteAssemblyException

Kommentarer

Egenskapen IgnoreCase avgör om jämförelsen av name med namnen på resurserna är skiftlägesokänslig (standard) eller skiftlägeskänslig.

Note

GetString(String) metod

Skrivbordsappar

Example

Kultur	Filnamn	Resursnamn	Resursvärde
en-US	DateStrings.txt	`DateStart`	Idag är
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Idag är det
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

Du kan använda följande batchfil för att kompilera C#-exemplet. För Visual Basic ändrar du csc till vbcoch ändrar filnamnstillägget för källkodsfilen från .cs till .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

Här är källkoden för exemplet (ShowDate.vb för Visual Basic-versionen eller ShowDate.cs för C#-versionen).

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.

GetString(String, CultureInfo) metod

Skrivbordsappar

I skrivbordsappar, om culture är null, GetString(String, CultureInfo) använder metoden den aktuella användargränssnittskulturen som hämtats från CultureInfo.CurrentUICulture egenskapen.

Example

Exemplet kräver de textbaserade resursfiler som anges i följande tabell. Var och en har en enskild strängresurs med namnet DateStart.

Kultur	Filnamn	Resursnamn	Resursvärde
en-US	DateStrings.txt	`DateStart`	Idag är
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Idag är det
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

Du kan använda följande batchfil för att kompilera Visual Basic-exemplet. Kompilera i C# genom att ändra vbc till cscoch ändra filnamnstillägget för källkodsfilen från .vb till .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

Här är källkoden för exemplet (ShowDate.vb för Visual Basic-versionen eller ShowDate.cs för C#-versionen).

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.

Trådsäkerhet

Metoden GetString(String, CultureInfo) är trådsäker.

Se även

Gäller för

Feedback

Var den här sidan till hjälp?