ResourceManager.CreateFileBasedResourceManager(String, String, Type) Method

Definition

Returns a ResourceManager object that searches a specific directory instead of an assembly manifest for resources.

C#
public static System.Resources.ResourceManager CreateFileBasedResourceManager (string baseName, string resourceDir, Type? usingResourceSet);
C#
public static System.Resources.ResourceManager CreateFileBasedResourceManager (string baseName, string resourceDir, Type usingResourceSet);

Parameters

baseName
String

The root name of the resources. 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 can be an absolute path or a relative path from the application directory.

usingResourceSet
Type

The type of the custom ResourceSet to use. If null, the default runtime ResourceSet object is used.

Returns

A new instance of a resource manager that searches the specified directory instead of an assembly manifest for resources.

Exceptions

The baseName or resourceDir parameter is null.

Remarks

This method returns a resource manager that retrieves resources from a .resources file that is not embedded in an assembly. You can use this ResourceManager object to load resources for an ASP.NET page or to test a ResourceSet implementation. For an example that retrieves resources from a standalone .resources file, see the Retrieving Resources article.

This method lets you specify a ResourceSet implementation. 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.

Caution

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. If you want to deploy resources with your ASP.NET apps, compile your .resources files into satellite assemblies.

Applies to

Product Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1