This documentation is archived and is not being maintained.

ResourceManager.CreateFileBasedResourceManager Method

Returns a ResourceManager that searches a specific directory for resources instead of in the assembly manifest.

Namespace:  System.Resources
Assembly:  mscorlib (in mscorlib.dll)

public static ResourceManager CreateFileBasedResourceManager(
	string baseName,
	string resourceDir,
	Type usingResourceSet


Type: System.String

The root name of the resources. For example, the root name for the resource file named "MyResource.en-US.resources" is "MyResource".

Type: System.String

The name of the directory to search for the resources.

Type: System.Type

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

Return Value

Type: System.Resources.ResourceManager
The newly created ResourceManager that searches a specific directory for resources instead of in the assembly manifest.


The baseName or resourceDir parameter is null.

This method returns a ResourceManager that is not dependent on any particular assembly. The returned ResourceManager can be used to load resources for an ASP.NET page or for testing a ResourceSet implementation.

You can specify a ResourceSet implementation. If you do not need a specific ResourceSet implementation, but would like to use a custom resource file format, you should derive from the ResourceSet class, override GetDefaultReader and GetDefaultWriter, and pass that type to this constructor.

Caution noteCaution:

Using standalone.resources files in an ASP.NET application will break XCOPY deployment because the resources remain locked until they are explicitly released by the ReleaseAllResources method. If you want to deploy resources into ASP.NET applications, compile your .resources into satellite assemblies.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0