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
public static ResourceManager CreateFileBasedResourceManager (
	String baseName, 
	String resourceDir, 
	Type usingResourceSet
public static function CreateFileBasedResourceManager (
	baseName : String, 
	resourceDir : String, 
	usingResourceSet : Type
) : ResourceManager



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


The name of the directory to search for the resources.


The Type of the custom ResourceSet to use. If a null reference (Nothing in Visual Basic), the default runtime ResourceSet is used.

Return Value

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

Exception typeCondition


The baseName ends in.resources.


The baseName parameter is a null reference (Nothing in Visual Basic).

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 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0