ResourceManager.GetString Метод

Определение

Пространство имен:: System.Resources

Сборки:: mscorlib.dll, System.Resources.ResourceManager.dll

Сборки:: netstandard.dll, System.Runtime.dll

Сборка:: System.Resources.ResourceManager.dll

Сборка:: mscorlib.dll

Сборка:: netstandard.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Возвращает указанный строковый ресурс для указанного языка и региональных параметров или текущего языка и региональных параметров пользовательского интерфейса.

Перегрузки

Имя	Описание
GetString(String)	Возвращает значение указанного ресурса строки.
GetString(String, CultureInfo)	Возвращает значение ресурса строки, локализованного для указанного языка и региональных параметров.

GetString(String)

Исходный код:: ResourceManager.cs

Исходный код:: ResourceManager.cs

Исходный код:: ResourceManager.cs

Исходный код:: ResourceManager.cs

Исходный код:: ResourceManager.cs

Возвращает значение указанного ресурса строки.

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

Параметры

name: String

Имя извлекаемого ресурса.

Возвращаемое значение

String

Значение ресурса, локализованного для текущего языка и региональных параметров пользовательского интерфейса вызывающего пользователя, или null если name не удается найти в наборе ресурсов.

Исключения

ArgumentNullException

Параметр name имеет значение null.

InvalidOperationException

Значение указанного ресурса не является строкой.

MissingManifestResourceException

Не найден доступный набор ресурсов и нет ресурсов для языка и региональных параметров по умолчанию. Сведения об обработке этого исключения см. в разделе "Обработка исключений MissingManifestResourceException и MissingSatelliteAssemblyException Exceptions" раздела ResourceManager "Обработка исключений MissingManifestResourceException".

MissingSatelliteAssemblyException

Ресурсы языка и региональных параметров по умолчанию находятся в вспомогательной сборке, которую не удалось найти. Сведения об обработке этого исключения см. в разделе "Обработка исключений MissingManifestResourceException и MissingSatelliteAssemblyException Exceptions" раздела ResourceManager "Обработка исключений MissingManifestResourceException".

Методы GetString могут вызывать больше исключений, чем перечислены. Одна из причин, по которой это может произойти, заключается в том, что метод, который вызывает этот метод, приводит к возникновению исключения. Например, может быть выброшено FileLoadException исключение, если произошла ошибка при развертывании или установке вспомогательной сборки, или SerializationException исключение может быть выброшено, если определяемый пользователем тип создает определяемое пользователем исключение при десериализации типа.

GetString(String)Метод

Настольные приложения

В настольных приложениях возвращаемый ресурс локализован для культуры пользовательского интерфейса текущего потока, как определено свойством CultureInfo.CurrentUICulture. Если ресурс не локализован для этой культуры, диспетчер ресурсов ищет ресурс, следуя действиям, описанным в разделе "Процесс возврата" статьи "Упаковка и развертывание ресурсов". Если не найден доступный набор локализованных ресурсов, диспетчер ресурсов переходит к ресурсам культуры по умолчанию. Если управляющий ресурсами не может загрузить набор ресурсов культуры по умолчанию, метод создает исключение MissingManifestResourceException или, если набор ресурсов ожидается в вспомогательной сборке, исключение MissingSatelliteAssemblyException. Если диспетчер ресурсов может загрузить соответствующий набор ресурсов, но не может найти именованный nameресурс, метод возвращается null.

Example

В следующем примере используется метод GetString для получения культуроспецифических ресурсов. Он состоит из ресурсов, скомпилированных из .txt файлов для английского языка (en), французского (Франция) (fr-FR) и российских (Россия) (ru-RU) культур. Пример изменяет текущую культуру и текущие культурные параметры пользовательского интерфейса на английский (США), французский (Франция), русский (Россия) и шведский (Швеция). Затем он вызывает метод GetString для получения локализованной строки, которая отображается вместе с текущим днем и месяцем. Обратите внимание, что результат отображает соответствующий локализованный текст, за исключением случаев, когда текущая культура пользовательского интерфейса — шведская (Швеция). Поскольку шведские языковые ресурсы недоступны, приложение вместо этого использует ресурсы языка по умолчанию, которым является английский. В примере требуются текстовые файлы ресурсов, перечисленные в следующей таблице. Каждый имеет один строковый ресурс с именем DateStart.

Культура	Имя файла	Имя ресурса	Значение ресурса
en-US	DateStrings.txt	`DateStart`	Сегодня
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Сегодня это
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

Для компиляции примера C# можно использовать следующий пакетный файл. Для Visual Basic измените csc на vbc, и измените расширение файла исходного кода с .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

Ниже приведен исходный код для примера (ShowDate.vb для версии Visual Basic или ShowDate.cs для версии 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.

GetString(String, CultureInfo)Метод

Настольные приложения

В настольных приложениях, если culture является null, метод GetString(String, CultureInfo) использует текущие параметры пользовательского интерфейса, полученные из свойства CultureInfo.CurrentUICulture.

Возвращаемый ресурс локализован для культуры, указанной параметром culture. Если ресурс не локализован для culture, диспетчер ресурсов ищет ресурс, следуя шагам, описанным в разделе "Процесс резервирования ресурсов" темы Упаковка и развертывание ресурсов. Если не найден доступный набор ресурсов, диспетчер ресурсов переходит к использованию ресурсов культуры по умолчанию. Если управляющий ресурсами не может загрузить набор ресурсов культуры по умолчанию, метод создает исключение MissingManifestResourceException или, если набор ресурсов ожидается в вспомогательной сборке, исключение MissingSatelliteAssemblyException. Если диспетчер ресурсов может загрузить соответствующий набор ресурсов, но не может найти именованный nameресурс, метод возвращается null.

Example

В следующем примере используется метод GetString(String, CultureInfo) для получения культуроспецифических ресурсов. В примере по умолчанию используется английский (en), а также вспомогательные сборки для французских (франция) (fr-FR) и российских (ru-RU) культур. Пример изменяет текущую культуру и культуру пользовательского интерфейса на русскую (Россия) перед вызовом GetString(String, CultureInfo). Затем он вызывает метод GetString и метод DateTime.ToString(String, IFormatProvider) и передает объекты CultureInfo, представляющие французскую (Франция) и шведскую (Швеция) культуры, в каждый метод. В выходных данных месяц и день месяца, а также строка, предшествующая им, отображается на французском языке, так как GetString метод может получить ресурс французского языка. Однако, когда используется шведский язык (Швеция), месяц и день месяца появляются на шведском языке, хотя строка, предшествующая им, находится на английском языке. Это связано с тем, что диспетчер ресурсов не может найти локализованные ресурсы на шведском языке, поэтому он возвращает ресурс для английского языка по умолчанию.

В примере требуются текстовые файлы ресурсов, перечисленные в следующей таблице. Каждый имеет один строковый ресурс с именем DateStart.

Культура	Имя файла	Имя ресурса	Значение ресурса
en-US	DateStrings.txt	`DateStart`	Сегодня
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Сегодня это
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

Для компиляции примера Visual Basic можно использовать следующий пакетный файл. Чтобы выполнить компиляцию в C#, измените vbc на csc и измените расширение файла исходного кода с .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

Ниже приведен исходный код для примера (ShowDate.vb для версии Visual Basic или ShowDate.cs для версии 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.

Потокобезопасность

Метод GetString(String) является потокобезопасной.

См. также раздел

Применяется к

GetString(String, CultureInfo)

Исходный код:: ResourceManager.cs

Исходный код:: ResourceManager.cs

Исходный код:: ResourceManager.cs

Исходный код:: ResourceManager.cs

Исходный код:: ResourceManager.cs

Возвращает значение ресурса строки, локализованного для указанного языка и региональных параметров.

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

Параметры

name: String

Имя извлекаемого ресурса.

culture: CultureInfo

Объект, представляющий язык и региональные параметры, для которых локализован ресурс.

Возвращаемое значение

String

Значение ресурса, локализованного для указанного языка и региональных параметров, или null если name не удается найти в наборе ресурсов.

Исключения

ArgumentNullException

Параметр name имеет значение null.

InvalidOperationException

Значение указанного ресурса не является строкой.

MissingManifestResourceException

MissingSatelliteAssemblyException

GetString(String)Метод

Настольные приложения

Example

Культура	Имя файла	Имя ресурса	Значение ресурса
en-US	DateStrings.txt	`DateStart`	Сегодня
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Сегодня это
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

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

Ниже приведен исходный код для примера (ShowDate.vb для версии Visual Basic или ShowDate.cs для версии 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.

GetString(String, CultureInfo)Метод

Настольные приложения

Example

Культура	Имя файла	Имя ресурса	Значение ресурса
en-US	DateStrings.txt	`DateStart`	Сегодня
fr-FR	DateStrings.fr-FR.txt	`DateStart`	Сегодня это
ru-RU	DateStrings.ru-RU.txt	`DateStart`	Сегодня

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

Ниже приведен исходный код для примера (ShowDate.vb для версии Visual Basic или ShowDate.cs для версии 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.

Потокобезопасность

Метод GetString(String, CultureInfo) является потокобезопасной.

См. также раздел

Применяется к

Кері байланыс

Бет пайдалы болды ма?

ResourceManager.GetString Метод

Определение

Перегрузки

GetString(String)

Параметры

Возвращаемое значение

Исключения

Комментарии

GetString(String)Метод

Настольные приложения

Example

GetString(String, CultureInfo)Метод

Настольные приложения

Example

Потокобезопасность

См. также раздел

Применяется к

GetString(String, CultureInfo)

Параметры

Возвращаемое значение

Исключения

Комментарии

GetString(String)Метод

Настольные приложения

Example

GetString(String, CultureInfo)Метод

Настольные приложения

Example

Потокобезопасность

См. также раздел

Применяется к