NeutralResourcesLanguageAttribute Class

Definition

Информирует диспетчер ресурсов о языке и региональных параметрах приложения по умолчанию.Informs the resource manager of an app's default culture. Этот класс не может быть унаследован.This class cannot be inherited.

public ref class NeutralResourcesLanguageAttribute sealed : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
public sealed class NeutralResourcesLanguageAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Assembly, AllowMultiple=false)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class NeutralResourcesLanguageAttribute : Attribute
type NeutralResourcesLanguageAttribute = class
    inherit Attribute
Public NotInheritable Class NeutralResourcesLanguageAttribute
Inherits Attribute
Inheritance
NeutralResourcesLanguageAttribute
Attributes

Examples

В следующем примере используется простое приложение "Hello World" для демонстрации использования атрибута NeutralResourcesLanguageAttribute для определения языка и региональных параметров по умолчанию или резервной версии.The following example uses a simple "Hello World" app to illustrate the use of the NeutralResourcesLanguageAttribute attribute to define a default or fallback culture. Для этого требуется создать отдельные файлы ресурсов для языков и региональных параметров "Английский (EN)", "Английский (США) (EN-US)" и "французский (Франция)" (fr-FR).It requires the creation of separate resource files for the English (en), English (United States) (en-US), and French (France) (fr-FR) cultures. Ниже показано содержимое текстового файла с именем Ексамплересаурцес. txt для английского языка и региональных параметров.The following shows the contents of a text file named ExampleResources.txt for the English culture.

# Resources for the default (en) culture.  
Greeting=Hello  

Чтобы использовать файл ресурсов в приложении, необходимо использовать генератор файлов ресурсов (Resgen. exe) для преобразования файла из текстового формата (txt) в двоичный формат (Resources) следующим образом:To use the resource file in an app, you must use the Resource File Generator (Resgen.exe) to convert the file from its text (.txt) format to a binary (.resources) format as follows:

resgen ExampleResources.txt  

При компиляции приложения двоичный файл ресурсов будет внедрен в основную сборку приложения.When the app is compiled, the binary resource file will be embedded in the main app assembly.

Ниже показано содержимое текстового файла с именем Ексамплересаурцес. en-US. txt, который предоставляет ресурсы для языка и региональных параметров "Английский (США)".The following shows the contents of a text file named ExampleResources.en-US.txt that provides resources for the English (United States) culture.

# Resources for the en-US culture.  
Greeting=Hi  

Текстовый файл можно преобразовать в двоичный файл ресурсов с помощью генератора файлов ресурсов (Resgen. exe) в командной строке следующим образом:The text file can be converted to a binary resources file by using the Resource File Generator (ResGen.exe) at the command line as follows:

resgen ExampleResources.en-US.txt ExampleResources.en-US.resources  

Затем двоичный файл ресурсов следует скомпилировать в сборку с помощью компоновщика сборок (Al. exe) и поместить в подкаталог en-US каталога приложения, выполнив следующую команду:The binary resource file should then be compiled into an assembly by using Assembly Linker (Al.exe) and placed in the en-US subdirectory of the app directory by issuing the following command:

al /t:lib /embed:ExampleResources.en-US.resources /culture:en-US /out:en-us\Example.resources.dll  

Ниже показано содержимое текстового файла с именем ExampleResources.fr-FR. txt, в котором содержатся ресурсы для языка и региональных параметров "французский (Франция)".The following shows the contents of a text file named ExampleResources.fr-FR.txt that provides resources for the French (France) culture.

# Resources for the fr-FR culture.  
Greeting=Bonjour  

Текстовый файл можно преобразовать в двоичный файл ресурсов с помощью ResGen. exe в командной строке следующим образом:The text file can be converted to a binary resource file by using ResGen.exe at the command line as follows:

resgen ExampleResources.fr-FR.txt ExampleResources.fr-FR.resources  

Затем файл двоичных ресурсов необходимо скомпилировать в сборку с помощью компоновщика сборок и поместить в подкаталог fr-FR каталога приложения, выполнив следующую команду:The binary resources file should then be compiled into an assembly by using Assembly Linker and placed in the fr-FR subdirectory of the app directory by issuing the following command:

al /t:lib /embed:ExampleResources.fr-FR.resources /culture:fr-FR /out:fr-FR\Example.resources.dll  

В следующем примере показан исполняемый код, который задает текущий язык и региональные параметры, запрашивает имя пользователя и отображает локализованную строку.The following example provides the executable code that sets the current culture, prompts for the user's name, and displays a localized string.

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

[assembly:NeutralResourcesLanguageAttribute("en")]
public class Example
{
   public static void Main()
   {
      // Select the current culture randomly to test resource fallback.
      string[] cultures = { "de-DE", "en-us", "fr-FR" };
      Random rnd = new Random();
      int index = rnd.Next(0, cultures.Length);
      Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultures[index]);
      Console.WriteLine("The current culture is {0}",
                        CultureInfo.CurrentUICulture.Name);

      // Retrieve the resource.
      ResourceManager rm = new ResourceManager("ExampleResources" ,
                                               typeof(Example).Assembly);
      string greeting = rm.GetString("Greeting");

      Console.Write("Enter your name: ");
      string name = Console.ReadLine();
      Console.WriteLine("{0} {1}!", greeting, name);
   }
}
Imports System.Globalization
Imports System.Reflection
Imports System.Resources
Imports System.Threading 

<Assembly:NeutralResourcesLanguageAttribute("en")>

Module Example
   Public Sub Main()
      ' Select the current culture randomly to test resource fallback.
      Dim cultures() As String = { "de-DE", "en-us", "fr-FR" }
      Dim rnd As New Random()
      Dim index As Integer = rnd.Next(0, cultures.Length)
      Thread.CurrentThread.CurrentUICulture = CultureInfo.CreateSpecificCulture(cultures(index))      
      Console.WriteLine("The current culture is {0}", 
                        CultureInfo.CurrentUICulture.Name)       

      ' Retrieve the resource.
      Dim rm As New ResourceManager("ExampleResources" , GetType(Example).Assembly)
      Dim greeting As String = rm.GetString("Greeting")
      
      Console.Write("Enter your name: ")
      Dim name As String = Console.ReadLine()
      Console.WriteLine("{0} {1}", greeting, name)
   End Sub
End Module

Его можно скомпилировать с помощью следующей команды в Visual Basic:It can be compiled by using the following command in Visual Basic:

vbc Example.vb /resource:ExampleResources.resources  

или с помощью следующей команды в C#:or by using the following command in C#:

csc Example.cs /resource:ExampleResources.resources  

Remarks

Классические приложенияDesktop Apps

В классических приложениях атрибут NeutralResourcesLanguageAttribute информирует диспетчер ресурсов о культуре приложения по умолчанию и расположении его ресурсов.In desktop apps, the NeutralResourcesLanguageAttribute attribute informs the resource manager of an app's default culture and the location of its resources. По умолчанию ресурсы внедряются в основную сборку приложения, и вы можете использовать атрибут следующим образом.By default, resources are embedded in the main app assembly, and you can use the attribute as follows. Эта инструкция указывает, что английский (США) является культурой по умолчанию для приложения.This statement specifies that the English (United States) is the app's default culture.

using System.Resources;

[assembly:NeutralResourcesLanguage("en-US")]
Imports System.Resources

<Assembly:NeutralResourcesLanguage("en-US")>

Можно также использовать атрибут NeutralResourcesLanguageAttribute, чтобы указать, где ResourceManager может найти ресурсы языка и региональных параметров по умолчанию, предоставляя значение перечисления UltimateResourceFallbackLocation в инструкции Attribute.You can also use the NeutralResourcesLanguageAttribute attribute to indicate where ResourceManager can find the resources of the default culture by providing an UltimateResourceFallbackLocation enumeration value in the attribute statement. Обычно это делается для указания того, что ресурсы находятся во вспомогательной сборке.This is most commonly done to indicate that the resources reside in a satellite assembly. Например, следующая инструкция указывает, что английский (США) является культурой по умолчанию или нейтральным языком приложения, а ее ресурсы находятся во вспомогательной сборке.For example, the following statement specifies that English (United States) is the app's default or neutral culture and that its resources reside in a satellite assembly. Объект ResourceManager будет искать их в подкаталоге en-US.The ResourceManager object will look for them in a subdirectory named en-US.

using System.Resources;

[assembly:NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)]
Imports System.Resources

<Assembly:NeutralResourcesLanguage("en-US", UltimateResourceFallbackLocation.Satellite)>

Tip

Для определения языка и региональных параметров по умолчанию для приложения рекомендуется всегда использовать атрибут NeutralResourcesLanguageAttribute.We recommend that you always use the NeutralResourcesLanguageAttribute attribute to define the default culture of your app.

Атрибут выполняет две роли:The attribute performs two roles:

  • Если ресурсы языка и региональных параметров по умолчанию внедряются в основную сборку приложения и ResourceManager должны получить ресурсы, которые принадлежат к той же культуре, что и язык и региональные параметры по умолчанию, ResourceManager автоматически использует ресурсы, расположенные в основной сборке, вместо поиска вспомогательной сборки.If the default culture's resources are embedded in the app's main assembly and ResourceManager has to retrieve resources that belong to the same culture as the default culture, the ResourceManager automatically uses the resources located in the main assembly instead of searching for a satellite assembly. Это обходит обычную проверку сборки, улучшает производительность поиска для первого загружаемого ресурса и может сократить рабочий набор.This bypasses the usual assembly probe, improves lookup performance for the first resource you load, and can reduce your working set. См. раздел Упаковка и развертывание ресурсов для процесса, который ResourceManager использует для проверки файлов ресурсов.See Packaging and Deploying Resources for the process ResourceManager uses to probe for resource files.

  • Если ресурсы языка и региональных параметров по умолчанию находятся во вспомогательной сборке, а не в основной сборке приложения, атрибут NeutralResourcesLanguageAttribute задает язык и региональные параметры, а также каталог, из которого среда выполнения может загрузить ресурсы.If the default culture's resources are located in a satellite assembly rather than in the main app assembly, the NeutralResourcesLanguageAttribute attribute specifies the culture and the directory from which the runtime can load the resources.

Приложения Магазин Windows 8.xWindows 8.x StoreМагазин Windows 8.xWindows 8.x Store Apps

В Магазин Windows 8.xWindows 8.x Store приложениях, ресурсы которых загружаются и извлекаются с помощью класса ResourceManager, атрибут NeutralResourcesLanguageAttribute определяет нейтральный язык и региональные параметры, ресурсы которых используются в случае сбоя проверки.In Магазин Windows 8.xWindows 8.x Store apps whose resources are loaded and retrieved by using the ResourceManager class, the NeutralResourcesLanguageAttribute attribute defines the neutral culture whose resources are used in the event of a failed probe. Он не указывает расположение ресурсов.It does not specify the location of the resources. По умолчанию ResourceManager использует файл индекса ресурсов пакета приложения (PRI) для нахождение ресурсов языка и региональных параметров по умолчанию.By default, ResourceManager uses the app's package resource index (PRI) file to locate the resources of the default culture. Нейтральный язык и региональные параметры, определяемые атрибутом NeutralResourcesLanguageAttribute, добавляются в конец списка языков пользовательского интерфейса для имитации этого воздействия.The neutral culture that is defined by the NeutralResourcesLanguageAttribute attribute is added to the end of the UI language list to simulate this effect.

При загрузке и извлечении ресурсов с помощью класса Среда выполнения WindowsWindows RuntimeWindows. ApplicationModel. Resources. ResourceLoader или типов в пространстве имен Windows. ApplicationModel. Resources. Core атрибут NeutralResourcesLanguageAttribute игнорируется.If you load and retrieve resources by using the Среда выполнения WindowsWindows RuntimeWindows.ApplicationModel.Resources.ResourceLoader class or the types in the Windows.ApplicationModel.Resources.Core namespace, the NeutralResourcesLanguageAttribute attribute is ignored.

Constructors

NeutralResourcesLanguageAttribute(String)

Инициализирует новый экземпляр класса NeutralResourcesLanguageAttribute.Initializes a new instance of the NeutralResourcesLanguageAttribute class.

NeutralResourcesLanguageAttribute(String, UltimateResourceFallbackLocation)

Инициализирует новый экземпляр класса NeutralResourcesLanguageAttribute с использованием заданного конечного местоположения резерва ресурсаInitializes a new instance of the NeutralResourcesLanguageAttribute class with the specified ultimate resource fallback location.

Properties

CultureName

Возвращает имя языка и региональных параметров.Gets the culture name.

Location

Возвращает расположение класса ResourceManager, применяемого для извлечения нейтральных ресурсов с помощью процесса использования резервных ресурсов.Gets the location for the ResourceManager class to use to retrieve neutral resources by using the resource fallback process.

TypeId

В случае реализации в производном классе возвращает уникальный идентификатор для этого атрибута Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Methods

Equals(Object)

Возвращает значение, показывающее, равен ли экземпляр указанному объекту.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode()

Возвращает хэш-код для этого экземпляра.Returns the hash code for this instance.

(Inherited from Attribute)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute()

При переопределении в производном классе указывает, является ли значение этого экземпляра значением по умолчанию для производного класса.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object)

При переопределении в производном классе возвращает значение, указывающее, является ли этот экземпляр равным заданному объекту.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Explicit Interface Implementations

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Сопоставляет набор имен соответствующему набору идентификаторов диспетчеризации.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Возвращает сведения о типе объекта, которые можно использовать для получения сведений о типе интерфейса.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Возвращает количество предоставляемых объектом интерфейсов для доступа к сведениям о типе (0 или 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Предоставляет доступ к открытым свойствам и методам объекта.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Applies to

See also