ResourceManager.CreateFileBasedResourceManager(String, String, Type) Метод

Определение

Возвращает объект ResourceManager, который ищет ресурсы в конкретном каталоге вместо манифеста сборки.Returns a ResourceManager object that searches a specific directory instead of an assembly manifest for resources.

public:
 static System::Resources::ResourceManager ^ CreateFileBasedResourceManager(System::String ^ baseName, System::String ^ resourceDir, Type ^ usingResourceSet);
public static System.Resources.ResourceManager CreateFileBasedResourceManager (string baseName, string resourceDir, Type? usingResourceSet);
public static System.Resources.ResourceManager CreateFileBasedResourceManager (string baseName, string resourceDir, Type usingResourceSet);
static member CreateFileBasedResourceManager : string * string * Type -> System.Resources.ResourceManager
Public Shared Function CreateFileBasedResourceManager (baseName As String, resourceDir As String, usingResourceSet As Type) As ResourceManager

Параметры

baseName
String

Имя корневой папки ресурсов.The root name of the resources. Например, имя корневой папки для файла ресурсов "MyResource.en-US.resources" будет "MyResource".For example, the root name for the resource file named "MyResource.en-US.resources" is "MyResource".

resourceDir
String

Имя папки, в которой производится поиск ресурсов.The name of the directory to search for the resources. resourceDir может быть абсолютным или относительным путем из каталога приложения.resourceDir can be an absolute path or a relative path from the application directory.

usingResourceSet
Type

Тип пользовательского объекта ResourceSet для использования.The type of the custom ResourceSet to use. При значении null используется объект времени выполнения по умолчанию ResourceSet.If null, the default runtime ResourceSet object is used.

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

ResourceManager

Новый экземпляр диспетчера ресурсов, который выполняет поиск ресурсов в указанном каталоге вместо манифеста сборки.A new instance of a resource manager that searches the specified directory instead of an assembly manifest for resources.

Исключения

Значение параметра baseName или параметра resourceDirnull.The baseName or resourceDir parameter is null.

Комментарии

Этот метод возвращает диспетчер ресурсов, который извлекает ресурсы из Resources-файла, который не внедрен в сборку.This method returns a resource manager that retrieves resources from a .resources file that is not embedded in an assembly. Этот объект можно использовать ResourceManager для загрузки ресурсов для страницы ASP.NET или для тестирования ResourceSet реализации.You can use this ResourceManager object to load resources for an ASP.NET page or to test a ResourceSet implementation. Пример, в котором ресурсы извлекаются из автономного Resources-файла, см. в статье получение ресурсов .For an example that retrieves resources from a standalone .resources file, see the Retrieving Resources article.

Этот метод позволяет указать ResourceSet реализацию.This method lets you specify a ResourceSet implementation. Если конкретная реализация не нужна ResourceSet , но требуется использовать формат файла пользовательского ресурса, следует наследовать от ResourceSet класса, переопределить GetDefaultReader GetDefaultWriter методы и и передать этот тип в этот конструктор.If you do not want a specific ResourceSet implementation, but would like to use a custom resource file format, you should derive from the ResourceSet class, override the GetDefaultReader and GetDefaultWriter methods, and pass that type to this constructor.

Внимание!

Использование автономных Resources-файлов в приложении ASP.NET приведет к нарушению развертывания XCOPY, так как ресурсы остаются заблокированными до тех пор, пока они не будут явно освобождены ReleaseAllResources методом.Using standalone .resources files in an ASP.NET app will break XCOPY deployment, because the resources remain locked until they are explicitly released by the ReleaseAllResources method. Если вы хотите развернуть ресурсы с помощью приложений ASP.NET, скомпилируйте свои Resources файлы во вспомогательные сборки.If you want to deploy resources with your ASP.NET apps, compile your .resources files into satellite assemblies.

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