NeutralResourcesLanguageAttribute Класс

Определение

Информирует диспетчер ресурсов о языке и региональных параметрах приложения по умолчанию.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)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class NeutralResourcesLanguageAttribute : Attribute
type NeutralResourcesLanguageAttribute = class
    inherit Attribute
Public NotInheritable Class NeutralResourcesLanguageAttribute
Inherits Attribute
Наследование
NeutralResourcesLanguageAttribute
Атрибуты

Примеры

В следующем примере используется простое приложение «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. Ниже показано содержимое текстового файла с именем ExampleResources.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.

Ниже показано содержимое текстового файла с именем ExampleResources.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  

Комментарии

Классические приложения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 значение перечисления в инструкции атрибута.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)>

Совет

Мы рекомендуем всегда использовать 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 Runtime Windows.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.

Конструкторы

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.

Свойства

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.

(Унаследовано от Attribute)

Методы

Equals(Object)

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

(Унаследовано от Attribute)
GetHashCode()

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

(Унаследовано от Attribute)
GetType()

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

(Унаследовано от Object)
IsDefaultAttribute()

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

(Унаследовано от Attribute)
Match(Object)

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

(Унаследовано от Attribute)
MemberwiseClone()

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

(Унаследовано от Object)
ToString()

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

(Унаследовано от Object)

Явные реализации интерфейса

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

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

(Унаследовано от 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.

(Унаследовано от Attribute)
_Attribute.GetTypeInfoCount(UInt32)

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

(Унаследовано от Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

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

(Унаследовано от Attribute)

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

Дополнительно