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

Определение

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

System.Resources

Сборка:

System.Runtime.dll

Инициализирует новый экземпляр класса ResourceManager.

Перегрузки

ResourceManager()	Инициализирует новый экземпляр класса ResourceManager со значениями по умолчанию.
ResourceManager(Type)	Инициализирует новый экземпляр класса ResourceManager, который ищет ресурсы в сопутствующих сборках, используя сведения из указанного объекта типа.
ResourceManager(String, Assembly)	Инициализирует новый экземпляр класса ResourceManager, который ищет ресурсы, содержащиеся в файлах с указанным корневым именем, в данной сборке.
ResourceManager(String, Assembly, Type)	Инициализирует новый экземпляр класса ResourceManager, который использует указанный класс ResourceSet для поиска ресурсов, содержащихся в файлах с указанным корневым именем, в данной сборке.

ResourceManager()

Исходный код:

ResourceManager.cs

Инициализирует новый экземпляр класса ResourceManager со значениями по умолчанию.

protected:
 ResourceManager();

protected ResourceManager ();

Protected Sub New ()

Комментарии

Этот конструктор полезен только при написании собственного ResourceManager класса, производного от класса .

ResourceManager(Type)

Исходный код:

ResourceManager.cs

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

public:
 ResourceManager(Type ^ resourceSource);

public ResourceManager (Type resourceSource);

new System.Resources.ResourceManager : Type -> System.Resources.ResourceManager

Public Sub New (resourceSource As Type)

Параметры

resourceSource

Type

Тип, из которого диспетчер ресурсов получает все сведения, необходимые для поиска RESOURCES-файлов.

Исключения

ArgumentNullException

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

Комментарии

Дополнительные сведения об этом API см. в разделе Дополнительные примечания API для конструктора ResourceManager.

ResourceManager(String, Assembly)

Исходный код:

ResourceManager.cs

Инициализирует новый экземпляр класса ResourceManager, который ищет ресурсы, содержащиеся в файлах с указанным корневым именем, в данной сборке.

public:
 ResourceManager(System::String ^ baseName, System::Reflection::Assembly ^ assembly);

public ResourceManager (string baseName, System.Reflection.Assembly assembly);

new System.Resources.ResourceManager : string * System.Reflection.Assembly -> System.Resources.ResourceManager

Public Sub New (baseName As String, assembly As Assembly)

Параметры

baseName

String

Корневое имя файла ресурсов без расширения, но включающее какое-либо полное имя пространства имен. Например, имя корневой папки для файла ресурсов MyApplication.MyResource.en-US.resources будет MyApplication.MyResource.

assembly

Assembly

Главная сборка для ресурсов.

Исключения

ArgumentNullException

Значение параметра baseName или параметра assembly — null.

Комментарии

Дополнительные сведения об этом API см. в разделе Дополнительные примечания API для конструктора ResourceManager.

Примечания для тех, кто наследует этот метод

Этот конструктор использует предоставленную ResourceSet системой реализацию. Чтобы использовать пользовательский формат файла ресурсов, необходимо наследовать от ResourceSet класса , переопределить GetDefaultReader() методы и GetDefaultWriter() и передать этот тип конструктору ResourceManager(String, Assembly, Type) . Использование пользовательского ResourceSet кода может быть полезно для управления политикой кэширования ресурсов или поддержки собственного формата файла ресурсов, но обычно это необязательно.

ResourceManager(String, Assembly, Type)

Исходный код:

ResourceManager.cs

Инициализирует новый экземпляр класса ResourceManager, который использует указанный класс ResourceSet для поиска ресурсов, содержащихся в файлах с указанным корневым именем, в данной сборке.

public:
 ResourceManager(System::String ^ baseName, System::Reflection::Assembly ^ assembly, Type ^ usingResourceSet);

public ResourceManager (string baseName, System.Reflection.Assembly assembly, Type? usingResourceSet);

new System.Resources.ResourceManager : string * System.Reflection.Assembly * Type -> System.Resources.ResourceManager

Public Sub New (baseName As String, assembly As Assembly, usingResourceSet As Type)

Параметры

baseName

String

Корневое имя файла ресурсов без расширения, но включающее какое-либо полное имя пространства имен. Например, имя корневой папки для файла ресурсов MyApplication.MyResource.en-US.resources будет MyApplication.MyResource.

assembly

Assembly

Главная сборка для ресурсов.

usingResourceSet

Type

Тип пользовательского объекта ResourceSet для использования. При значении null используется объект времени выполнения по умолчанию ResourceSet.

Исключения

ArgumentException

Объект usingResourceset не является производным от класса ResourceSet.

ArgumentNullException

Значение параметра baseName или параметра assembly — null.

Комментарии

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

Примечание

Чтобы получить ресурсы из RESOURCES-файлов напрямую, а не из сборок, необходимо вызвать CreateFileBasedResourceManager метод , чтобы создать ResourceManager экземпляр объекта .

Если файл ресурсов, идентифицируемый параметром baseName , не найден в assembly, метод создает ResourceManager экземпляр объекта, но попытка получить определенный ресурс вызывает исключение, обычно MissingManifestResourceException. Сведения о диагностике причины исключения см. в разделе "Обработка исключения MissingManifestResourceException" раздела класса ResourceManager .

Примечание

Параметр usingResourceSet используется для поддержки собственного формата ресурсов и обычно имеет значение null. Это отличается от конструктора, который принимает Type только .

Примечания для тех, кто вызывает этот метод

Этот конструктор позволяет указать реализацию ResourceSet . Если вы не хотите использовать определенную ResourceSet реализацию, но хотите использовать пользовательский формат файла ресурсов, следует наследовать от ResourceSet класса , переопределить GetDefaultReader() методы и и GetDefaultWriter() передать этот тип в этот конструктор.