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
Not applicable.



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 or resourceDir 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 Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0